升级指南
页面导读
适用场景适合从旧版本升级到新版本，或商业版交付中替换后端、前端和数据库脚本。
前置条件已确认当前版本、目标版本、升级 SQL、部署方式和回滚窗口。
升级对象数据库、后端 jar、前端静态资源、移动端、可视化、缓存、时序库和授权配置。
验收点服务启动正常，核心业务链路可用，数据不丢失，版本功能按预期生效。
一、升级前准备
| 准备项 | 说明 |
|---|---|
| 确认版本 | 记录当前版本和目标版本 |
| 备份数据库 | MySQL、时序库、OSS 文件、配置文件 |
| 备份部署包 | 后端 jar、前端目录、docker-compose、Nginx 配置 |
| 阅读变更 | 查看版本说明和 SQL 升级脚本 |
| 测试演练 | 先在测试环境完整演练 |
| 回滚方案 | 明确回滚包、数据库备份和停机窗口 |
二、升级顺序
三、SQL 脚本
SQL 位于源码仓库：
text
springboot/sql常见脚本类型：
| 类型 | 说明 |
|---|---|
| 主版本初始化脚本 | 新部署使用，如 fastbee-v2.9.0.sql |
| 版本升级脚本 | 旧版本升级到新版本使用，如 fastbee2.8.0-upgrade-v2.9.0.sql |
| 多数据库脚本 | 达梦、人大金仓、Oracle、Postgres、SQL Server |
| 时序库脚本 | IoTDB、TDengine 初始化 |
| AI 初始化脚本 | AI 表和初始化数据 |
警告
升级 SQL 必须按版本顺序执行，不要跨版本跳过脚本。执行前必须备份数据库。
四、Docker 部署升级
常见路径：
| 文件 | 位置 |
|---|---|
| 后端 jar | /var/data/java/ |
| 前端资源 | /var/data/nginx/vue/ |
| 可视化资源 | /var/data/nginx/view/ |
| Nginx 配置 | /var/data/nginx/ 或部署包配置目录 |
替换后重启服务：
shell
cd /var/data
docker-compose restart java
docker-compose restart nginx五、缓存与时序库
部分版本升级涉及缓存结构、设备数据权限或时序库超级表变更。需要根据版本说明处理：
| 场景 | 处理建议 |
|---|---|
| 设备消息缓存变更 | 清理 Redis 中对应业务 Key |
| Modbus 配置变更 | 清理 Modbus 相关缓存 |
| 物模型结构变更 | 重启服务并验证设备模型 |
| TDengine 表结构变更 | 按版本说明处理超级表和历史数据 |
| IoTDB 初始化 | 确认脚本和连接配置 |
六、升级后验收
| 验收项 | 正常表现 |
|---|---|
| 登录 | 管理员可登录，菜单正常 |
| 产品设备 | 产品、设备、物模型可查询 |
| 设备接入 | MQTTX 可上线、上报、下发 |
| 数据中心 | 历史数据、报表可查询 |
| 规则告警 | 规则、场景、告警能触发 |
| 通知工单 | 通知发送、工单生成正常 |
| 视频 | 直播、通道、录像按需可用 |
| AI | 模型、知识库、对话按需可用 |
七、回滚策略
如果升级失败：
- 停止新版本服务。
- 恢复旧版 jar 和前端目录。
- 恢复数据库备份。
- 恢复 Nginx 和配置文件。
- 启动旧版本服务。
- 重新执行升级问题分析。