达希物联：设备超过30分钟没上报就标离线

移动网络下的设备常处于间歇在线状态，若业务应用直接向设备下发配置，可能在设备休眠时丢失或顺序错乱。

影子解决什么问题

设备影子（Device Shadow）在云端维护一份 JSON 形态的状态文档，分离“应用期望的配置/属性”（desired）与“设备实际上报的状态”（reported）。应用只与影子交互，由平台在设备上线时推送差异，从模式上消除竞态。达希设备管理平台将影子作为一等公民，与配置下发、规则引擎共享同一状态源。影子同时覆盖应用期望态、设备上报态、版本冲突检测，以及离线指令在弱网下的缓存重放。

JSON 结构包含 metadata、desired、reported 与 delta 片段，每次更新递增版本号，拒绝过期写操作。应用 PATCH desired 后平台计算 diff 生成 delta，设备上线拉取并应用后上报 reported，渐进收敛。版本向量检测并发写冲突，拒绝过期操作；支持回滚到历史版本，高敏参数引入二次审批。同步流程依次为应用写入 Desired、平台计算 Delta、设备拉取并执行、上报 Reported。

平台能力与文档结构

平台把 Desired 与 Reported 分离：应用只写期望态，设备只报实际态，平台自动计算差异并推送。版本化与冲突检测在每次更新时递增版本号，拒绝过期写操作，防止多方同时改配置互覆盖。设备休眠时指令暂存影子，上线后自动推送差异，弱网场景分批确认。按角色限制 desired 字段写权限，高敏参数支持二次审批或双人复核。控制台展示 desired 与 reported 实时差异，未收敛字段触发告警联动。

典型文档包含 metadata（版本号、时间戳）、desired、reported、delta 片段。平台在每次更新时递增版本，拒绝过期写操作，避免两个运维同时改配置后互相覆盖。对于大字段（如整页规则集），可采用分片键或引用对象存储 URL，保持影子体积可控。当应用 PATCH desired 后，平台计算与 reported 的 diff，生成 delta 消息；设备上线拉取或订阅 delta，应用成功后上报 reported。若设备部分字段无法立即生效，应上报 pending 原因，影子中保留未收敛标记，触发告警。弱网下可结合连接韧性策略，允许设备分批确认。

权限、边界与验收

影子偏运行态同步，数字孪生可在此基础上叠加仿真与历史轨迹。达希客户在部分项目中把影子作为孪生体的实时层，将批量聚合结果写入时序存储。谁可以修改 desired 应有 RBAC 约束：客服可能仅能改展示类参数，而研发可改采样周期。每次变更写入审计日志，支持回滚到历史版本。对高敏参数（如解锁指令）可引入二次审批或双人复核。

不应把影子当作通用消息队列高频写入；高频遥测仍应走遥测管道。避免在影子中存储敏感明文凭证，应使用引用令牌。desired 与 reported 字段集合应对齐 schema，否则 delta 计算会出现大量噪声。影子文档体积与更新频率应设上限，超大 JSON 会影响 diff 计算与存储成本。对批量设备配置变更优先使用配置模板与分批任务，而不是同时对百万设备写入巨型 desired。建议在集成测试中加入乱序上报、部分字段失败与断网重放场景，验证版本号与 pending 标记是否符合预期。验收清单包含冲突写拒绝行为、回滚能力、审计字段完整性。设备影子让云端意图与现场真相在弱网世界中仍可渐进收敛。达希设备管理平台提供版本化影子 API、可视化 diff、告警联动与配额治理，帮助应用团队减少自研状态机复杂度。

新闻来源：https://www.simtolink.com/product/dmp/device-shadow-state.html