一、项目简介本项目是一个基于 SpringBoot3 Vue3 MySQL 的天气服务平台采用前后端分离架构。系统核心能力包括实时天气查询、未来天气预报、历史天气统计、天气预警推送、城市收藏管理等并内置了和风天气 API 对接能力支持 API 数据自动回退与手动拉取入库。平台分为普通用户端与管理员端两个角色普通用户可注册登录、查询天气、管理收藏城市、查看预警与统计图表管理员则负责用户、城市、天气数据、预警信息、轮播图的管理以及和风天气 API 的同步配置与数据导入。项目附带完整源码、数据库初始化脚本与万字开发文档适合作为毕业设计、课程设计或 Java 全栈学习的参考项目。二、技术栈技术说明后端框架SpringBoot 3.xORMMyBatis-Plus分页插件、逻辑删除、字段自动填充权限认证Spring Security JWTjjwt前端框架Vue 3Composition API路由与守卫Vue Router前端路由守卫UI 组件Element Plus构建工具Vite数据库MySQL 8.xHTTP 客户端RestTemplate和风天气 API 调用文件存储本地磁盘上传UUID 重命名三、功能模块管理员端仪表盘统计展示用户总数、城市总数、天气数据总条数、启用预警数量为运营提供全局概览。用户管理分页查询用户列表支持按用户名或昵称模糊搜索可启用/禁用用户账号、删除用户。城市管理分页查询城市列表支持关键字搜索可新增/编辑城市信息城市编码、名称、省份、经纬度删除城市。天气数据管理分页查询天气数据支持按城市编码和城市名筛选可手工新增/编辑天气记录删除历史数据。预警管理分页查询预警列表支持按城市名和预警等级筛选可新增/编辑预警类型、等级、标题、描述、起止时间、状态删除预警。轮播图管理查看轮播图列表支持新增/编辑轮播图标题、图片 URL、链接地址、排序值、状态上传轮播图片删除轮播图。API 同步配置查看 API 配置状态是否配置 Key、连通性测试、错误信息提示便于排查对接问题。API 城市搜索通过内置中国城市库按关键字搜索城市支持城市名/省份/拼音标记是否已导入数据库。API 城市导入将选中的城市批量导入数据库自动跳过已存在的城市编码避免重复数据。API 天气拉取指定城市编码和天数拉取和风天气数据并入库按城市日期去重存在则更新、不存在则新增。API 批量拉取一次提交多个城市编码批量拉取天气数据并入库返回每个城市的拉取结果。普通用户端用户注册与登录通过用户名和密码完成注册登录成功后签发 JWT Token支持角色识别USER/ADMIN。实时天气查询输入城市编码获取当前天气优先调用和风天气 APIAPI 异常时自动回退数据库最新数据。天气预报查询支持按城市编码查询未来 3 天或 7 天预报包含最高/最低温、湿度、风向风力、降水等字段。历史天气查询按城市编码及起止日期筛选历史天气记录按日期升序返回完整温度、湿度、降水数据。天气统计图表获取近 30 天温度、湿度、降水序列数据支持前端渲染折线图/柱状图。城市搜索支持按城市名或省份模糊搜索城市列表展示城市编码、名称、经纬度。城市收藏管理查看收藏列表按排序字段升序、添加收藏传 cityCode 和 cityName、取消收藏、检查是否已收藏。天气预警查看获取全部启用的预警列表按创建时间倒序可按城市编码筛选启用中的预警。个人资料修改更新昵称、邮箱、手机号、头像字段修改后实时生效。密码修改校验原密码后更新为新密码使用 BCrypt 加密存储。头像上传上传图片文件返回访问 URL自动更新用户头像字段。首页轮播图获取启用状态的轮播图列表按排序值升序展示。四、项目总结本项目技术栈覆盖了当前 Java 全栈开发的主流选型SpringBoot3 作为后端基础MyBatis-Plus 简化数据访问Spring Security JWT 保证接口安全前端采用 Vue3 Element Plus Vite具备良好的开发体验与组件化能力。项目在业务上完整实现了天气数据从外部 API 拉取、入库、查询、统计到展示的全链路且具备 API 异常回退机制体现了真实项目中的容错设计。功能模块划分清晰角色权限明确适合作为学习前后端分离开发、JWT 认证、第三方 API 对接、数据可视化等技术的实战参考项目也可直接用于毕业设计或小型天气服务平台的二次开发基础。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K336