15 设备影子与命令控制¶

难度：中级｜前置：MQTT、在线状态、状态机｜目标：处理离线设备、状态同步和命令回执

为什么不能只“发一条命令”¶

平台下发：

把温度阈值设为 30。

可能发生：

因此需要区分“希望设备是什么状态”和“设备报告自己是什么状态”。

{
  "desired": {"threshold": 30},
  "reported": {"threshold": 28},
  "version": 12
}

影子适合最终状态同步，不适合所有瞬时动作。

set threshold = 30

重复执行结果相同，更容易幂等。

reboot
take_photo
dispense_once

可能产生一次性副作用，需要 command_id、回执、超时和幂等。

created
→ dispatched
→ received
→ executing
→ succeeded / failed / timeout

Broker 接收成功不等于设备执行成功。回执应关联稳定的 command_id。

设备收到版本 12 后又收到版本 11，应拒绝旧版本。服务器也不能用旧 reported 覆盖新状态。

如果业务只需要同一设备内的顺序，可以按 device_id 分区，不必追求所有设备的全局顺序。

必须明确策略：