单片机与物联网 / 系统课时
跟踪 PUBLISH 消息传输
跟踪 PUBLISH 消息传输
设备向 lab/temperature 发布一次测温值时,Broker 接收到的不只是主题和数据。PUBLISH 中的 QoS、DUP、RETAIN 以及有条件出现的 Packet Identifier,会影响确认、重发与后续订阅者看到的内容。本课用 MQTT 3.1.1 和 Mosquitto 将字段对照到实际传输。
学习目标
- 分辨 PUBLISH 固定报头、可变报头和载荷中的字段。
- 按 QoS 0、1、2 的往返报文解释 Packet Identifier 与 DUP。
- 验证 QoS 1 发布、保留消息以及新订阅者的可见结果。
从报文结构定位字段
MQTT 3.1.1 的 PUBLISH 固定报头包含报文类型、DUP、QoS、RETAIN 和剩余长度。可变报头先放 Topic Name,当 QoS>0 时再放两字节的 Packet Identifier;最后才是消息载荷。
例如发布 Topic lab/temperature、载荷 26.5,数据载荷占 4 个 ASCII 字节。Topic 是 UTF-8 主题名,发布时不能含订阅过滤器通配符 + 或 #。载荷可为任意字节,不应默认所有设备报文都是 JSON。

QoS 决定何时需要 Packet Identifier
Packet Identifier 是该方向上进行中 QoS 1/2 报文交换的标识,范围为 1 到 65535;确认链完成后才可按规则复用。QoS 0 的 PUBLISH 没有这个字段,不能因为抓包显示主题后立即是载荷就认定报文缺失。
| QoS | 发送方向上的确认链 | 交付语义 |
|---|---|---|
0 |
PUBLISH,无确认 | 至多一次,允许丢失 |
1 |
PUBLISH → PUBACK | 至少一次,可能重复 |
2 |
PUBLISH → PUBREC → PUBREL → PUBCOMP | 协议层恰好一次 |
QoS 1 的 PUBACK 通过同一 Packet Identifier 对应之前的 PUBLISH。它说明发送方与当前接收方在这段 MQTT 链路上的确认完成,不代表所有订阅者已经执行业务处理。QoS 2 的四步握手解决协议层重复交付问题,但不能替代数据库写入、订单处理等业务幂等机制。
DUP 和 RETAIN 分别在回答什么
DUP=0 表示该 PUBLISH 不是重传;DUP=1 表示发送方正在重发此前的 PUBLISH,常见于持久会话断线恢复。它不等于“业务消息已经被消费两次”。QoS 0 的 DUP 必须是 0;Broker 转发给订阅者时,会独立决定转发报文的 DUP 位。
RETAIN=1 则让 Broker 保存这个 Topic 最新的一条保留消息。此后即使发布者离线,新订阅者订阅匹配主题时也能收到该快照。已有订阅者收到正常实时转发时,MQTT 3.1.1 的 RETAIN 为 0;因新订阅而下发保留消息时为 1。后续用 RETAIN=0 发布新值,并不会改写原有保留值。
保留消息并不是历史队列:同一 Topic 只保留最新一条;发布 RETAIN=1 且载荷长度为零的消息可清除该 Topic 的保留值。RETAIN 与 QoS 是不同维度,QoS=1 本身不会自动保留消息。
复现一次确认与保留消息下发
先确保本机 Broker 监听 127.0.0.1:1883,并安装 mosquitto_pub、mosquitto_sub。依次运行以下命令:发布者先结束,再启动全新的订阅者。这能避免把实时转发误认为保留消息。
# QoS 1 发布温度值,并要求 Broker 保留最新状态
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -i sensor-01 -t lab/temperature -m '26.5' -q 1 -r -d
# 发布者已退出后再订阅,仅接收一条消息便退出
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -i monitor-01 -t lab/temperature -C 1 -v预期输出(订阅命令的标准输出;发布端还会另行打印调试日志):
lab/temperature 26.5发布端的 -d 调试日志应能看到 PUBLISH 的 q1、r1 标记,以及随后收到的 PUBACK;Packet Identifier 的具体数值可能变化。第二条命令在发布结束后仍能收到 26.5,说明 Broker 保存并向新订阅者发送了这条保留消息。
从症状反查是哪一段出了问题
如果发布端收到了 PUBACK,但在线监控没有显示温度,先检查监控端是否成功收到 SUBACK、订阅 Topic 是否与 lab/temperature 匹配,以及 Broker 对发布和订阅分别应用的权限。Topic 区分大小写,lab/Temperature 是另一个主题。
如果新订阅者只看到旧温度,则检查最新一次发布是否漏了 -r:非保留发布不会覆盖已存的 retained 状态。如果抓包中 QoS 1/2 PUBLISH 找不到 Packet Identifier,核对报文解析是否正确;如果因断线恢复看到 DUP=1,应检查 QoS 确认链和接收端去重逻辑,而不是直接把它当作第二次业务操作。
定位时分开记录发布链路的 PUBLISH/PUBACK、Broker 的订阅转发和 RETAIN 的存储行为,才能判断问题发生在发送确认、主题路由还是状态快照。