单片机与物联网 / 系统课时
验证 QoS 1 为什么会重复
验证 QoS 1 为什么会重复
同一条设备消息已经送到 Broker,发布端却因为没有处理确认而重发,订阅者可能再次收到相同内容。用 MQTT 3.1.1 报文和本机 Broker 复现这一场景,找到重复产生的具体位置。
学习目标
- 识别 QoS 1 的
PUBLISH、PUBACK、DUP和 Packet Identifier。 - 通过持久会话重连观察同一业务消息被交付两次。
- 区分协议重发标记与真正可用于业务去重的标识。
确认丢失为何引出第二次交付
发布端发送 PUBLISH(QoS=1, DUP=0, Packet Identifier=7),Broker 接收后回复 PUBACK(7),并可向匹配的订阅者转发。若发布端没有收到或处理确认,它仍会保留编号 7 的待确认报文。
MQTT 3.1.1 规定:以 Clean Session=0 恢复会话时,未确认的 QoS 1 PUBLISH 必须用原报文标识重发,并设置 DUP=1。此时 Broker 可能再次分发相同业务内容。发布端与订阅端是两段独立的 QoS 链路,订阅端收到的第二份内容不一定带有 DUP=1。

在本机 Broker 复现重复
准备一个允许本地测试连接的 MQTT 3.1.1 Broker,监听 127.0.0.1:1883;安装 Mosquitto 客户端命令与 Python 3。先在终端 A 启动 QoS 1 订阅,保持窗口打开。
mosquitto_sub -h 127.0.0.1 -p 1883 -t lab/qos1 -q 1 -v预期结果:命令等待消息,发布前没有输出。将下面完整程序保存为 qos1_retry.py,在终端 B 执行 python qos1_retry.py。程序只处理剩余长度小于 128 字节的演示报文,首轮故意不读取 PUBACK,模拟确认对发布程序不可见;这不代表网络真的丢了 TCP 数据包。
import socket
import time
HOST, PORT = '127.0.0.1', 1883
def mqtt_text(text):
data = text.encode('utf-8')
return len(data).to_bytes(2, 'big') + data
def frame(header, body):
# 教学报文足够短,仅编码单字节 Remaining Length
assert len(body) < 128
return bytes([header, len(body)]) + body
def read4(sock):
data = b''
while len(data) < 4:
chunk = sock.recv(4 - len(data))
if not chunk:
raise ConnectionError('连接提前关闭')
data += chunk
return data
def connect():
sock = socket.create_connection((HOST, PORT), timeout=5)
# MQTT 3.1.1、Clean Session=0、Keep Alive=60 秒
header = bytes.fromhex('00044d5154540400003c')
sock.sendall(frame(0x10, header + mqtt_text('qos1-retry-pub')))
ack = read4(sock)
assert ack[:2] == bytes.fromhex('2002') and ack[3] == 0
return sock
body = mqtt_text('lab/qos1') + bytes.fromhex('0007') + b'order=42'
with connect() as sock:
sock.sendall(frame(0x32, body)) # QoS=1,DUP=0,报文标识 7
time.sleep(0.5) # 让 Broker 处理,但不读取首个 PUBACK
with connect() as sock:
sock.sendall(frame(0x3A, body)) # 同一标识,重发时 DUP=1
assert read4(sock) == bytes.fromhex('40020007')
print('PUBACK(7) received')预期输出(发布端):
PUBACK(7) received预期输出(订阅端,在无其他发布者干扰时):
lab/qos1 order=42
lab/qos1 order=42抓包应该核对哪些字段
抓取本机环回接口流量,使用 Wireshark 显示过滤器 mqtt && tcp.port == 1883。发布端到 Broker 的关键序列应是首次 PUBLISH(0x32, id=7)、PUBACK(7),连接中断后出现 PUBLISH(0x3A, id=7)、PUBACK(7)。其中 0x3A 的 DUP 位为 1,消息体仍是 order=42。
Packet Identifier=7 只用于这一次链路上的收发确认,确认后允许复用,不是全局消息 ID。对于开闸、计费、创建订单等不能重复执行的操作,应让载荷包含稳定的 eventId,由业务服务以设备标识与 eventId 组成幂等键,并在持久化事务中拒绝重复处理。QoS 1 负责至少一次交付,业务幂等负责防止重复副作用。