单片机与物联网 / 系统课时

消息重复时从哪里定位

消息重复时从哪里定位

消费端两次收到同一设备事件时,不能立刻断定是 MQTT 协议重传。先把发布端、Broker 和消费端的记录按时间对齐,再结合 DUP 标志、报文标识符与业务事件 ID,才能区分协议重发、重连补发和应用重复发布,并找到应修复的位置。

学习目标

  • 区分一次业务事件与一次 MQTT PUBLISH 报文。
  • 根据 DUP、QoS、连接时间线和事件 ID 缩小重复来源。
  • 用可复现实验与业务唯一键验证定位和修复效果。

先判断重复出现在哪一跳

假设设备 motor-07 上报事件 eventId=evt-42,消费端连续处理了两次。需要同时采集发布端调用 publish 的次数、Broker 收到与转发的次数、消费端接收及业务落库的次数。记录至少包含客户端 ID、Topic、QoS、事件 ID、时间戳、连接/重连状态,以及能取得的 DUP、Packet Identifier 和 RETAIN 标志。

发布端到 Broker、Broker 到订阅端是两段独立的 MQTT 投递。两段各有自己的确认与重传状态,因此不能用订阅端看到的 DUP 推断发布端是否曾经重传,也不能把 Packet Identifier 当作跨客户端唯一的消息编号。

重复消息的来源及逐跳排查关系

正确读取 DUP 与业务事件 ID

DUP 是单个 MQTT PUBLISH 报文在当前传输方向上的重投递标志。DUP=1 表示发送方尝试再次发送该报文,不证明接收方此前已经收到;DUP=0 也不证明业务内容从未出现过。QoS 0 的 PUBLISH 不使用 DUP 重发机制。

观察到的证据 优先检查
同一链路、同一未确认报文重发,DUP=1 查对应 QoS 1 的 PUBACK 或 QoS 2 的握手是否中断
Broker 入站已有两次相同 eventId 的新发布 查设备定时任务、失败重试和重连回调是否重复调用 publish
Broker 只收到一次,订阅端却多次接收 查出站确认、会话恢复、重新订阅与保留消息投递
载荷相同但 eventId 不同 先判断是否是两次真实业务事件,不能仅凭载荷判重

Packet Identifier 在一次客户端与服务器的链路交互中使用,确认完成后可以复用。对于跨重连、跨设备的排障,应以业务方生成的稳定 eventId 贯通日志,并用 ClientID 与连接时间辅助确认传输上下文。重复订阅或重新订阅时,还要检查 RETAIN 标志与订阅过滤器是否重叠。

用两次发布复现业务层重复

准备已安装 Mosquitto 命令行工具、允许本机测试连接的 Broker。以下使用 127.0.0.1:1883,仅用于隔离测试;受保护环境需换成实际地址、端口和认证/TLS 参数。先在终端 A 开始订阅:

bash
# 终端 A:收到两条非保留消息后自动退出
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -i diag-dup-sub -q 1 -t 'lab/dup/motor-07' -R -C 2 -v -d

预期结果:成功建立连接并完成订阅后等待消息。-d 输出协议调试信息;若连接失败,应先排查 Broker 可达性和认证。

在终端 A 订阅成功后,于终端 B 执行:

bash
# 终端 B:两次独立发布携带相同业务事件 ID
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -q 1 -t 'lab/dup/motor-07' -m '{"eventId":"evt-42","value":1}'
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -q 1 -t 'lab/dup/motor-07' -m '{"eventId":"evt-42","value":1}'

预期输出(终端 A 的消息行,其他调试日志因版本而异):

text
lab/dup/motor-07 {"eventId":"evt-42","value":1}
lab/dup/motor-07 {"eventId":"evt-42","value":1}

这里是两次独立的应用发布,而非人为制造丢失 PUBACK 的协议重传。即使两次接收都显示 DUP=0,业务仍收到了重复事件。排查线上故障时,可以在测试 Broker 短时启用报文调试日志,按入站、出站方向分别对照发布次数与确认记录;不要在生产环境长期记录敏感载荷。

定位后让业务只执行一次

若源头是应用回调重复触发,应修复发布逻辑;若是未完成确认后的协议重投递,应修复网络或客户端循环阻塞问题,同时保留正常的 QoS 重试。对于任何可能产生重投递的链路,消费端都应在写入业务结果的同一数据库事务内,对 (tenantId, deviceId, eventId) 建立唯一约束;遇到已存在的事件时跳过副作用,必要时返回原处理结果。

判断完成的标准是:能指出重复发生在入站发布、出站重投递或消费处理中的哪一段,并证明同一 eventId 即使收到两次也只产生一次业务副作用。协议细节可对照 MQTT 3.1.1 规范。

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

目录与阅读设置

阅读设置

17

记录一个想法

消息重复时从哪里定位

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

登录哪都通