单片机与物联网 / 系统课时
抓包还原一次完整会话
抓包还原一次完整会话
客户端显示连接成功、消息已发送,并不代表我们已经理解 Broker 实际交换了哪些报文。本课使用 Mosquitto 命令行客户端和 Wireshark,抓取一条 QoS 1 温度消息,按时间还原连接、订阅、发布、确认和断开的完整过程,并学会通过报文定位通信问题。
学习目标
- 使用 Wireshark 捕获本机 MQTT 明文流量,识别连接中的主要控制报文。
- 区分发布端和订阅端的 TCP 连接,正确配对 SUBACK 与 PUBACK。
- 根据实际抓包判断消息是否经过 Broker 转发,以及会话是否正常结束。
准备能够解析的 MQTT 流量
本例使用 MQTT 3.1.1 协议,Broker 监听 127.0.0.1:1883,不启用 TLS,允许本地客户端连接。需要提前安装 Mosquitto Broker、mosquitto_pub、mosquitto_sub 和 Wireshark,并确认 Broker 已经运行。
实验使用两个不同的客户端标识:trace-sub 负责订阅,trace-pub 负责发布。主题统一为 lab/trace/temperature,消息内容为 24.5,发布和订阅的 QoS 均为 1。
打开 Wireshark 后,按下面的顺序准备抓包:
- 选择承载
127.0.0.1通信的回环接口。Linux 通常为lo,macOS 通常为lo0,Windows 可使用 Npcap 提供的 Loopback Adapter。 - 开始捕获,在显示过滤器输入
tcp.port == 1883,保留 TCP 建连、MQTT 报文与断开过程。 - 确认过滤器可以显示流量后,再启动客户端,避免漏掉最开始的 CONNECT 报文。
- 需要只查看 MQTT 控制报文时,将显示过滤器改为
mqtt。
运行一次订阅与发布
首先在终端 A 启动订阅客户端。-V mqttv311 固定协议版本,-q 1 请求 QoS 1,-d 打印调试信息,-v 同时显示主题和消息内容,-C 1 表示收到一条符合条件的消息后退出。
# 先建立订阅,确保发布时 Broker 已有匹配的订阅者
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv311 -i trace-sub -t lab/trace/temperature -q 1 -C 1 -v -d预期结果:订阅端完成连接与订阅,调试信息能够看到 CONNECT、CONNACK、SUBSCRIBE 和 SUBACK 对应的收发记录,随后等待业务消息。此时不要关闭终端。
确认订阅成功后,在终端 B 发布一条温度消息:
# 使用 QoS 1 发布一条非保留消息
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -i trace-pub -t lab/trace/temperature -m 24.5 -q 1 -d预期输出(订阅终端的业务消息行,其他调试日志省略):
lab/trace/temperature 24.5发布客户端完成 QoS 1 确认后正常退出,订阅客户端收到一条消息后也会退出。发布端调试输出中的消息编号、具体日志格式可能随客户端版本不同而变化。
如果订阅端在发布之前就收到了旧消息并退出,可能是该主题存在 Retained Message。应改用一个未使用过的测试主题,并同时修改两条命令中的 -t 参数。
按两个 TCP 连接还原报文顺序
回到 Wireshark,可以使用 Follow、TCP Stream 功能查看单条 TCP 连接,再返回数据包列表检查 MQTT 报文。发布端和订阅端各有一条独立连接,不能把所有报文误认为发生在同一连接中。
订阅端连接应包含以下过程:
trace-sub向 Broker 发送 CONNECT,Broker 返回 CONNACK,表示连接请求得到处理。- 订阅端发送 SUBSCRIBE,请求
lab/trace/temperature的 QoS 1 订阅。 - Broker 返回 SUBACK,确认订阅结果。对于成功授予 QoS 1 的 MQTT 3.1.1 订阅,返回码为
0x01。 - 发布发生后,Broker 在订阅端连接上发送 PUBLISH,订阅端返回 PUBACK。
- 订阅端处理完消息后正常退出,并向 Broker 发送 DISCONNECT。
发布端连接则包含 CONNECT、CONNACK、PUBLISH、PUBACK 和 DISCONNECT。这里的 PUBACK 是 Broker 对发布端的 QoS 1 消息确认,并不表示最终订阅者已经完成处理。

观察图中两个 PUBACK 的方向:一个由 Broker 发给发布端,另一个由订阅端发给 Broker。这是两段独立的 QoS 1 交付过程。Broker 不必等待订阅端完成确认,才向原发布端发送 PUBACK,因此两个确认在真实抓包中的先后可能不同。
从报文字段验证交付结果
选中 Wireshark 中的 MQTT PUBLISH 报文,展开 MQTT 协议字段,重点核对主题、QoS、DUP、RETAIN、Packet Identifier 和消息载荷。
| 检查项 | 本例应观察到的内容 | 判断用途 |
|---|---|---|
| Topic | lab/trace/temperature |
确认路由目标 |
| Payload | 24.5 |
确认业务内容一致 |
| QoS | 1 |
确认使用至少一次交付 |
| DUP | 首次发送为 0 |
判断该报文是否标记为重传 |
| RETAIN | 发布端发送时为 0 |
排除本次主动发布的保留标记 |
| Packet Identifier | PUBLISH 与同连接 PUBACK 对应 | 配对确认消息 |
Packet Identifier 的匹配范围是当前发送方与接收方之间的连接。发布端到 Broker 的标识符,不要求等于 Broker 到订阅端的标识符,即使数值偶然相同,也不能据此判断它们属于同一个确认过程。
同时注意,SUBACK 负责确认订阅请求,PUBACK 负责确认 QoS 1 PUBLISH。不能将 SUBACK 视为业务消息已经送达的证据。TCP 自身的 ACK 也不是 MQTT PUBACK。
根据缺失报文定位问题
抓包排障时,应先寻找通信链路上最后一个确定成功的步骤,再判断后续报文为什么没有出现。
- 看不到 CONNECT:先确认抓取了正确的网络接口、客户端是否实际建立 TCP 连接,以及 Broker 地址和端口是否正确。
- 已有 CONNECT 但没有正常的 CONNACK:检查 Broker 日志、认证配置和连接中断情况。MQTT 3.1.1 的 CONNACK 返回码也可能直接指示连接被拒绝。
- 已收到 SUBACK 但订阅端没有 PUBLISH:核对 SUBACK 是否成功、主题是否匹配,以及消息发布时订阅端是否仍在线。
- 发布端已经发送 QoS 1 PUBLISH,却未观察到 PUBACK:检查连接中断、Broker 处理情况,以及抓包是否完整。不能仅凭一次抓包缺失就断言 Broker 没有处理消息。
- 看不到 DISCONNECT:确认客户端是否正常退出。异常断网、进程被强制结束或抓包提前停止,都可能导致该报文缺失。
最后可以在 Wireshark 中分别核对两条连接的报文数量和方向。如果发布端的 PUBLISH 与 PUBACK 配对成功、订阅端收到相同业务消息并返回自己的 PUBACK,就能证实这次 QoS 1 消息已经完成两段 MQTT 交付。至于订阅端是否完成数据库写入、告警计算等业务动作,仍需要应用层日志或业务确认来验证。