单片机与物联网 / 系统课时
验证离线期间消息如何保存
验证离线期间消息如何保存
设备离线后,Broker 不会无条件保存发往它的每条消息。这里用 Mosquitto 依次完成订阅、断线、离线发布与恢复连接,验证持久会话中的消息何时入队、何时补发,并区分离线队列与保留消息。
学习目标
- 使用固定 Client ID 和 MQTT 3.1.1 持久会话保留订阅。
- 验证 QoS 1 消息在订阅端离线时的排队与补发。
- 识别会话消失、队列限制和 Retained 消息造成的不同结果。
哪些消息会进入离线队列
在 MQTT 3.1.1 中,客户端必须使用相同的 Client ID,并在 CONNECT 时设置 Clean Session=0。首次连接先完成 QoS 1 订阅,收到 SUBACK 后再离线;Broker 才知道应把哪些主题的消息放入该会话。
断开后,Broker 应保留匹配订阅的 QoS 1、QoS 2 待投递消息。QoS 0 是否缓存取决于服务端实现,不应依赖它恢复离线消息。订阅 QoS 是交付上限,本次统一采用发布 QoS 1、订阅 QoS 1。
MQTT 5 则需组合 Clean Start=0 与非零 Session Expiry Interval;不能把 MQTT 3.1.1 的 Clean Session 直接当作同一个字段。
发布确认与恢复投递的时序
订阅端离线时,发布者仍能与 Broker 完成 PUBLISH/PUBACK。这个 PUBACK 只确认发布者到 Broker 的交付,不表示离线订阅者已收到。相同 Client ID 恢复会话后,Broker 才向订阅者转发队列中的消息并等待另一次 PUBACK。

用命令复现一次补发
准备已启动的本机 Mosquitto Broker,以及 mosquitto_sub、mosquitto_pub 命令。以下使用 127.0.0.1:1883 和未被使用过的客户端 ID offline-test-01;实际环境应替换为相应的 <PORT>、<ID>。不要在生产设备的真实会话上运行。
先在终端 A 建立持久订阅。看到调试日志里的 SUBACK 后,按 Ctrl+C 正常退出。
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -i offline-test-01 -c -q 1 -t lab/offline/notice -d -v预期结果:出现成功的 CONNACK 和 SUBACK。退出后 TCP 连接关闭,但 Broker 仍保留这条订阅所属的持久会话。
在订阅端离线期间,于终端 B 发布一条非 Retained 的 QoS 1 消息。这里刻意不加 -r,以免把保留消息误认为离线补发。
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -q 1 -t lab/offline/notice -m queued-001预期结果:命令成功退出,默认不打印消息内容;离线订阅端不会立即看到消息。
最后在终端 C 以同一个 ID 和 -c 恢复连接;-C 1 表示收到一条消息后退出。
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -i offline-test-01 -c -q 1 -t lab/offline/notice -C 1 -v预期输出:
lab/offline/notice queued-001收不到消息时检查什么
- 没有补发:先确认最初已收到 SUBACK;再检查重连的 Client ID 是否一致、是否始终使用
-c、Broker 是否启用了队列限制或清理策略。 - 收到的只是最新值:检查发布时是否加了
-r。Retained 是按主题保存最后一条保留消息的机制,不等于为某个离线客户端积累的消息队列。 - Broker 重启后队列丢失:会话保留不自动代表消息已写入磁盘;还需核对 Broker 的持久化配置与实际恢复行为。
- QoS 0 没有补发:这不违反 MQTT 3.1.1 的离线保存规则;需要可靠补发时改用适当的 QoS 1 或 QoS 2。
会话队列还受服务端容量和管理策略约束。真实设备恢复后,应检查 CONNACK 的 Session Present:为 1 表示恢复旧会话,为 0 表示需要重新订阅。QoS 1 允许重复交付,业务处理也应具备幂等性。