单片机与物联网 / 系统课时
离线消息积压怎么定位
离线消息积压怎么定位
设备离线后重连,可能一次收到大量旧消息,也可能发现部分指令始终未到。定位时应先确认订阅会话是否仍存在,再检查每客户端待发队列、确认进度、队列限额和消息过期规则,区分正常补发、慢消费者与真正的消息丢失。
学习目标
- 判断离线消息进入持久会话队列的必要条件。
- 用 Mosquitto 的状态主题与客户端证据缩小积压范围。
- 根据限额、过期和消费速率制定修复及回归验证方案。
先确认消息是否具备离线保存条件
先定位一个有问题的 ClientID,核对它离线前是否成功订阅了目标 Topic,以及断开、重连时是否保留了同一个客户端标识。
MQTT 3.1.1 需要 Clean Session=false;MQTT 5 需要非零的 Session Expiry Interval,且重连时不以 Clean Start=true 清除旧会话。若会话已过期、首次订阅尚未建立或 Topic 不匹配,Broker 不会为这条订阅补发离线消息。
正常情况下,持久会话可保存符合订阅条件的 QoS 1/2 消息;发布端为 QoS 0 时不会因为订阅 QoS 1 而自动升级。Mosquitto 默认不为断线客户端排队 QoS 0,可通过 queue_qos0_messages 查看是否改过该行为。MQTT 5 的消息过期时间还可能使原本进入队列的消息失效。
还原队列与确认的实际位置
Broker 按 Topic 将消息路由到各订阅会话。离线且有效的持久会话可拥有自己的待发队列;在线消费者处理或确认缓慢,则可能出现未完成的 QoS 1/2 交付与后续待发消息。两种情况都可能表现为积压,但修复方向不同。

抓取 Broker 证据并关联客户端
以下命令适用于安装了 mosquitto_sub、允许本机访问且开放 $SYS 读取权限的测试 Broker。生产环境应使用授权的只读监控账号与 TLS 参数,不要为排障临时开放匿名访问。
# 在本机诊断 Broker 中观察离线会话、存储和丢弃指标
mosquitto_sub -h 127.0.0.1 -p 1883 \
-t '$SYS/broker/clients/disconnected' \
-t '$SYS/broker/store/messages/count' \
-t '$SYS/broker/mqtt/publish/dropped' \
-v -W 30预期输出(节选;实际数值、顺序和重复次数会随运行状态变化):
$SYS/broker/clients/disconnected <COUNT>
$SYS/broker/store/messages/count <COUNT>
$SYS/broker/mqtt/publish/dropped <COUNT>连续比较两个采样时点:clients/disconnected 表示仍保留会话的离线客户端数;store/messages/count 包括保留消息与持久会话队列,不能直接视为离线消息条数;mqtt/publish/dropped 记录因发送中或排队限额而丢弃的 PUBLISH 累计数。$SYS 是 Broker 汇总视角,不提供可靠的逐客户端队列明细,还要对照服务端连接日志、订阅记录、客户端收到及确认数量。无输出时优先查 sys_interval、ACL 和连接参数,不能直接判断数值为零。
核对限额、过期与生产行为
例如一个订阅者离线 5 分钟,匹配的 QoS 1 消息每秒 10 条,就有 3000 条候选消息。若该客户端 max_queued_messages=1000,队列无法无条件保存全部候选消息;若消息另设 60 秒有效期,重连时更早的消息还可能已过期。不能据此假设一定能收到最新 600 条,因为队列满时后续消息也可能被拒绝入队。
核查 Mosquitto 的 max_queued_messages、max_queued_bytes、max_inflight_messages、queue_qos0_messages 和适用的会话过期配置。persistence true 影响 Broker 重启后的会话及消息恢复,并不是运行中离线排队的唯一前提。核对实际版本和生效配置后再调整,勿直接把队列设成无限大。配置细节见 Mosquitto 官方手册。
按证据修复并验收
- 会话消失:固定
ClientID,纠正清理会话的连接选项,检查会话过期时间与重连间隔。 - 离线队列超限:缩窄订阅 Topic,降低非关键遥测频率或聚合消息;在容量评估后调整单客户端队列上限。
- 在线消费者滞后:测量客户端接收、处理及 QoS 确认速率,优先解决阻塞回调和网络拥塞;不要仅增加 Broker 内存。
- 旧消息不应再执行:给时效性指令设置 MQTT 5 消息有效期,消费端再按业务时间戳和唯一键拒绝过期或重复动作。
复测时固定一个 ClientID:记录离线前订阅、断线期间发布的业务消息标识、重连后的接收顺序与实际处理结果,并观察丢弃计数是否继续增长。对于 QoS 1/2,协议确认不等于业务已执行;关键命令还需要应用层结果回执。