智能制造与工业软件 / 系统课时

识别保留消息与实时状态的差别

识别保留消息与实时状态的差别

设备停止上报后,新订阅的 MQTT 看板仍可能立刻看到一个温度值,因为 Broker 保存了该主题的 Retained 消息。本课用本地命令复现这一现象,再把“最近一次值”和“当前有效值”分开判断,避免把过期读数当作实时状态。

学习目标

  • 解释 Retained 消息在新订阅时的投递行为,并与实时推送区分。
  • 用 Mosquitto 命令写入、读取和清除保留值。
  • 根据测量时间戳、心跳和在线状态判定读数是否可用。

保留的是最后一条消息,不是数据仍在更新

发布端设置 RETAIN=1 时,Broker 按完整主题名保存最后一条保留消息及其 QoS。后来建立的新订阅只要匹配该主题,就会收到这份快照;即使设备早已断开连接,消息也可能存在。对同一主题发布 RETAIN=0 的新消息,只会正常转发,不会替换原有保留值。

MQTT 保留消息与实时推送的时序差别

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℃,最后才启动新订阅者。

bash
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 时间):

text
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℃”。

建议将两个判断分开:

  1. 测量有效性:measuredAt 存在且可解析,数据年龄不超过 15 秒;若时间戳超前服务器超过 2 秒,标为时钟异常。现场设备与平台应校时,必要时同时保存网关接收时间。
  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 且载荷长度为零的消息即可清除缓存,普通非保留发布无法完成清除。

bash
# -n 发送零字节载荷,配合 -r 删除该主题保留值
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -r -n -t 'demo/machine01/telemetry/temperature'

预期结果:命令成功时通常没有终端输出;之后启动的新订阅者不会再立即收到这个主题的保留值,直到有新的消息发布。已在线的订阅者可能收到空载荷消息,消费端应识别它,而不是把空内容解析成温度零值。

验收时分别检查“新订阅立即读到最后值”“非保留消息不覆盖旧快照”“超过 15 秒标记过期”“零载荷删除后不再补发”。这样才能把最后已知状态与真正可用的实时状态区分开。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

识别保留消息与实时状态的差别

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通