🚀 版本概要

本次更新是 ThingsPanel 的一次重大版本升级，核心聚焦在 MQTT 消息处理架构的全面重构 与 多层网关设备的完整支持。

我们重写了关键的数据流转与通信逻辑，彻底提升了系统的 性能、扩展性与稳定性，为大规模设备接入与复杂物联网场景打下坚实基础。

同时修改了众多Bug，改善了系统的可用性。

🎯 主要亮点

🌐 多层网关设备支持（全新特性）

支持“网关 → 子网关 → 终端设备”的多层结构通信。

● 支持多层级设备的上下行数据转发与命令穿透。

● 网关与子设备间的绑定、事件、属性、遥测均可完整传递。

● 彻底解决复杂组网环境下的数据孤岛问题。

● 已通过全场景自动化测试验证，确保高稳定性。

🔹 用户价值：

适用于分布式工厂、园区、边缘计算场景，可轻松管理成百上千台分层网关设备。

⚙️ MQTT 消息架构重构（核心升级）

这次我们重新设计了整个 MQTT 消息处理管线。

● 将遥测、事件、命令、状态更新统一到一套消息流中。

● 优化消息分发逻辑，减少重复订阅与阻塞。

● 重构 MQTT 适配器，提升可扩展性，支持未来更多协议。

● 自动重连时恢复订阅，彻底解决断线后消息丢失问题。

🔹 用户价值：

设备消息传递更稳、更快，平台响应速度显著提升，尤其适合高并发接入场景。

🔄 WebSocket 实时推送优化

● 使用 Redis Pub/Sub 替代 MQTT 实现设备状态实时推送。

● 减少中间依赖，推送更快更稳定。

● 优化客户端订阅机制，确保状态变化“秒级”响应。

🔹 用户价值：

设备状态变化实时可见，前端仪表盘更新更流畅。

👤 用户系统增强

● 手机号支持国际区号格式查询。

● 用户信息新增地址管理（增删改查接口）。

● 个人资料支持头像与地址完善。

🔹 用户价值：

支持全球化部署场景，提升用户信息管理的灵活性。

📢 告警与通知优化

● Webhook 推送内容更丰富，包含设备详细信息。

● 优化消息结构，减少冗余字段，格式更规范。

● 统一使用标准 UUID，增强系统一致性。

🧱 架构与性能优化

● 整合 Flow 与 MQTT 模块，形成统一数据处理入口。

● 优化存储层缓冲机制，减少资源占用。

● 统一日志格式与关键字段，便于后期监控与排查。

🔹 用户价值：

系统更轻量、运行更快、日志更清晰，易于运维与监控。

🧩 修复的问题

● 修复设备模板为空时报错问题。

● 修复设备编号修改后需手动重连的 bug。

● 修复自动化任务无法启动与锁竞争问题。

● 修复修改手机号后无法登录问题。

● 修复遥测数据批量插入冲突、看板类型不生效等问题。

● 优化 SSE 接口，防止连接被 Nginx 提前关闭。

⚠️ 升级须知

1. Redis 必须启用（WebSocket 推送依赖 Redis Pub/Sub）。

2. 数据库需执行迁移脚本（新增用户地址字段）。

3. MQTT 重连机制已更新，升级后设备将自动恢复订阅。

4. 使用网关设备的用户需重点验证多层级通信链路。

💡 建议操作

● 升级前备份数据库。

● 检查 MQTT 与 Redis 服务运行状态。

● 测试设备上下行与告警推送功能是否正常