water/.workbuddy/memory/2026-06-10.md

2026-06-10 工作日志

MQTT 分发重构 & 设备下发业务层

9. MqttMessageDispatcher 策略模式重构

问题：Dispatcher 硬编码 7 个 Regex Pattern 的 if-else 链，新增 Topic 必须改 Dispatcher 类。

方案：

• 创建 MqttTopicHandler 接口（topicPattern() + handle(deviceNo, payload)）
• 每个 Handler 实现该接口并声明自己的 Topic 正则
• MqttMessageDispatcher 改为注入 List<MqttTopicHandler>，启动时自动收集，循环匹配
• 新增 Topic：只需新增 Handler Bean，Dispatcher 零改动

修复的 Bug：

• DeviceCommandAckHandler 原来是空壳（只打日志），现在委托到 IDeviceCommandAckHandler → MqttCommandAckService
• DeviceStatusHandler 原来存在但 Dispatcher 从未路由到它（缺少 PATTERN），现已补全
• 新增 ScheduleFinishHandler、KeyFinishHandler、DeviceCommandReceiptHandler 替代原来只打日志的空处理

文件变更：

文件	变更
app/mqtt/MqttTopicHandler.java	新增 策略接口
app/mqtt/MqttMessageDispatcher.java	重写 策略模式
app/handler/DeviceDataHandler.java	实现 MqttTopicHandler
app/handler/DeviceRegisterHandler.java	实现 MqttTopicHandler
app/handler/DeviceStatusHandler.java	实现 MqttTopicHandler（新增 /status Topic）
app/handler/ErromesHandler.java	实现 MqttTopicHandler
app/handler/DeviceCommandAckHandler.java	实现 MqttTopicHandler + 委托 IDeviceCommandAckHandler
app/handler/ScheduleFinishHandler.java	新增
app/handler/KeyFinishHandler.java	新增
app/handler/DeviceCommandReceiptHandler.java	新增

10. 新增设备下发业务层 DeviceCommandService

问题：AppDeviceServiceImpl.switchDevice() 直接拼装 DeviceCommand 并调用底层 IDeviceCommandPublisher，缺少统一的下发入口。

方案：

• 创建 IDeviceCommandService 接口
• DeviceCommandServiceImpl 封装命令构造、设备校验、下发生效、浇水日志
• 提供类型化方法：sendSwitchCommand()、sendCustomCommand()、sendCommand()
• AppDeviceServiceImpl.switchDevice() 改为调用 deviceCommandService.sendSwitchCommand()

文件变更：

文件	变更
app/service/IDeviceCommandService.java	新增 接口
app/service/impl/DeviceCommandServiceImpl.java	新增 实现
app/service/impl/AppDeviceServiceImpl.java	重构 switchDevice，注入 IDeviceCommandService，移除废弃的私有方法

11. 修复循环依赖根因

MqttCommandAckService.mqttClientManager 字段保留 final 导致 Lombok @RequiredArgsConstructor 仍将其放入构造器，@Lazy 注解在字段上不生效。已去掉 final，确保字段注入 + @Lazy 代理正确工作。

12. 删除冗余 /publish/status Topic

设备上传电量数据本身就证明在线，单独的 /publish/status Topic 没必要。删除 DeviceStatusHandler 和 AppMqttDeviceStatusProperties。策略模式下 Dispatcher 自动感知，零改动。

13. 修复两处循环依赖（构造器注入导致）

大循环（6个Bean）：

DeviceMqttCommandPublisher → MqttClientManager → MqttMessageDispatcher
  → DeviceRegisterHandler → AppDeviceServiceImpl → DeviceCommandServiceImpl
  → DeviceMqttCommandPublisher（闭合）

修复：DeviceCommandServiceImpl.commandPublisher 去掉 final，改为 @Lazy @Autowired 字段注入。

双向循环（2个Bean）：

AppDeviceServiceImpl ↔ DeviceCommandServiceImpl

修复：AppDeviceServiceImpl.deviceCommandService 去掉 final，改为 @Lazy @Autowired 字段注入。