智能制造与工业软件 / 系统课时
识别保留消息与实时状态的差别
识别保留消息与实时状态的差别
设备停止上报后,新订阅的 MQTT 看板仍可能立刻看到一个温度值,因为 Broker 保存了该主题的 Retained 消息。本课用本地命令复现这一现象,再把“最近一次值”和“当前有效值”分开判断,避免把过期读数当作实时状态。
学习目标
- 解释 Retained 消息在新订阅时的投递行为,并与实时推送区分。
- 用 Mosquitto 命令写入、读取和清除保留值。
- 根据测量时间戳、心跳和在线状态判定读数是否可用。
保留的是最后一条消息,不是数据仍在更新
发布端设置 RETAIN=1 时,Broker 按完整主题名保存最后一条保留消息及其 QoS。后来建立的新订阅只要匹配该主题,就会收到这份快照;即使设备早已断开连接,消息也可能存在。对同一主题发布 RETAIN=0 的新消息,只会正常转发,不会替换原有保留值。

Retained 不是事件历史,也不同于持久会话中的离线消息队列。MQTT 3.1.1 的保留值不会因客户端使用 Clean Session 而删除;MQTT 5 可通过 Message Expiry Interval 让消息到期,但业务侧仍须检查测量时间。Broker 是否能在重启后恢复保留值,还取决于服务端的持久化配置。
用命令验证旧快照会再次出现
准备本机运行的 MQTT Broker(监听 127.0.0.1:1883、允许本地测试连接),并安装 mosquitto_pub 与 mosquitto_sub。以下使用 Bash,先写入 23.6℃ 的保留值,再发布一次不带保留标志的新值 24.1℃,最后才启动新订阅者。
TOPIC='demo/machine01/telemetry/temperature'
TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
PAYLOAD=$(printf '{"value":23.6,"unit":"C","measuredAt":"%s"}' "$TS")
# -r 保留消息;-q 1 使用至少一次投递语义
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -r -t "$TOPIC" -m "$PAYLOAD"
# 新值未指定 -r,不会覆盖 Broker 中已有的保留值
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -t "$TOPIC" -m '{"value":24.1,"unit":"C"}'
mosquitto_sub -h 127.0.0.1 -p 1883 -C 1 -v -t "$TOPIC"预期输出(<TIME> 为执行时的 UTC 时间):
demo/machine01/telemetry/temperature {"value":23.6,"unit":"C","measuredAt":"<TIME>"}-C 1 表示收到一条消息后退出,-v 显示主题与载荷。尽管 24.1 比 23.6 更新,新订阅者拿到的依然是 23.6:收到消息只能证明 Broker 有缓存,不能证明设备刚刚采样。
结合时间戳和在线信号判断有效性
假设设备每 5 秒测一次温度,业务允许最多 15 秒的读数延迟。平台在显示时用当前 UTC 时间减去 measuredAt:若设备 08:00:00 测得 23.6℃,看板在 08:00:20 读取到它,数据年龄为 20 秒,应显示“过期”,而不是“当前 23.6℃”。
建议将两个判断分开:
- 测量有效性:
measuredAt存在且可解析,数据年龄不超过 15 秒;若时间戳超前服务器超过 2 秒,标为时钟异常。现场设备与平台应校时,必要时同时保存网关接收时间。 - 连接在线性:设备连接时发布保留的
online,异常断线使用 Retained Last Will 发布offline;正常退出时主动发布offline。再结合周期心跳及其时间戳判断,心跳超时则显示“未知/失联”,不能只相信缓存中的online。
在线不等于读数新鲜:设备通信正常但传感器卡死时,心跳可继续更新,温度仍须单独判为过期。对告警与联锁等控制用途,不得仅凭 retained 快照执行动作。
按主题用途选择保留策略
| 主题示例 | 是否保留 | 消费端处理 |
|---|---|---|
demo/machine01/config/sample_interval_s |
是 | 新客户端接入即读取最新配置,例如 5 秒 |
demo/machine01/status |
是 | 配合遗嘱消息、心跳时间判断在线可信度 |
demo/machine01/telemetry/temperature |
按需 | 看板要展示最后值时可保留,但必须校验 measuredAt |
demo/machine01/events/alarm |
否 | 每次告警作为事件入库;历史查询依赖数据库,而非 Retained |
若目标只是实时曲线,测量主题默认不保留更不易误解;若目标是新看板打开即可显示“最后已知值”,允许保留,但界面必须展示采样时间和新鲜度状态。
删除无效快照并验收
当传感器点位撤销或误发旧保留值时,向同一主题发布 RETAIN=1 且载荷长度为零的消息即可清除缓存,普通非保留发布无法完成清除。
# -n 发送零字节载荷,配合 -r 删除该主题保留值
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -r -n -t 'demo/machine01/telemetry/temperature'预期结果:命令成功时通常没有终端输出;之后启动的新订阅者不会再立即收到这个主题的保留值,直到有新的消息发布。已在线的订阅者可能收到空载荷消息,消费端应识别它,而不是把空内容解析成温度零值。
验收时分别检查“新订阅立即读到最后值”“非保留消息不覆盖旧快照”“超过 15 秒标记过期”“零载荷删除后不再补发”。这样才能把最后已知状态与真正可用的实时状态区分开。