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

跟踪 CONNECT 建连过程

跟踪 CONNECT 建连过程

设备连上 Broker 的 TCP 端口后,MQTT 会话还未必建立。只有理解 CONNECT 请求与 CONNACK 响应,才能判断客户端标识、心跳设置、会话恢复及拒绝原因。本课用 MQTT 3.1.1 和 Mosquitto 的调试日志还原一次建连。

学习目标

  • 按顺序辨认 CONNECT、CONNACK 与空闲心跳报文。
  • 解释 Client ID、Clean Session、Keep Alive 和 Session Present。
  • 在本机复现建连,并用返回码缩小故障范围。

连接实际经过哪几步

启动设备客户端后,先与 Broker 建立 TCP 连接;启用 TLS 时还要先完成 TLS 握手。客户端发送的第一份 MQTT 控制报文是 CONNECT,Broker 接受后返回 CONNACK。只有 CONNACK 返回码为 0x00 才算 MQTT 层建连成功,之后才能发送 SUBSCRIBE 或 PUBLISH。

CONNECT 不携带业务 Topic,也不代表已经订阅成功;SUBSCRIBE/SUBACK 属于后续独立的交互。若 Broker 拒绝连接,可能返回非零 CONNACK 后关闭连接;收到不合法报文时,也可能直接断开。

CONNECT、CONNACK 与空闲心跳的消息时序

CONNECT 中决定会话行为的字段

MQTT 3.1.1 的 CONNECT 可变报头包含 Protocol Name=MQTT、Protocol Level=4、连接标志与 Keep Alive;载荷包含 Client ID,并按标志决定是否附带遗嘱、用户名和密码。

  • Client ID=probe-01 标识设备会话。同一 Broker 上若新连接占用正在使用的 ID,旧连接会被断开;实际部署应给设备分配稳定且唯一的 ID。
  • Clean Session=1 表示丢弃旧会话状态并开始新会话;设为 0 则请求恢复 Broker 保留的会话状态,例如已有订阅与未完成的 QoS 交互。
  • Keep Alive=30 表示相邻 MQTT 控制报文之间允许的最大空闲间隔为 30 秒。已有 PUBLISH 等报文时无需另发心跳;真正空闲时由客户端发送 PINGREQ,Broker 回复 PINGRESP。
  • Will Flag 决定是否提交遗嘱消息;User Name Flag 和 Password Flag 决定认证字段是否存在。不能把这些 CONNECT 标志误读为 PUBLISH 的 RETAIN 或 DUP。

CONNACK 怎样表示接受与拒绝

CONNACK 没有业务载荷。首先看 Connect Return Code,再看 Session Present。若 Clean Session=1 且连接成功,Session Present 必须为 0;只有请求保留会话且 Broker 找到了旧会话,成功响应才可能带 Session Present=1。

返回码 MQTT 3.1.1 含义 排查方向
0x00 接受连接 可继续业务交换
0x01 不支持协议级别 检查客户端版本
0x02 拒绝客户端标识 检查 ID 限制
0x03 服务不可用 检查 Broker 状态
0x04 用户名或密码不被接受 检查凭证格式
0x05 未获授权 检查身份与访问策略

非零返回码不是“部分连接成功”;Broker 发送拒绝响应后会关闭网络连接。若根本没有 CONNACK,则还不能用这些返回码判断问题。

用调试日志复现握手

准备好 mosquitto_pub,并确保本机 127.0.0.1:1883 已运行允许测试客户端连接的 MQTT Broker。以下使用未加密且无认证的本机环境;生产环境应配置身份认证和 TLS。

bash
# 显式指定协议版本、客户端标识与 30 秒心跳间隔
mosquitto_pub -h 127.0.0.1 -p 1883 -V mqttv311 -i probe-01 -k 30 -t lab/probe -m online -q 0 -d

预期输出(调试日志中的关键两行,其余发布与断开日志略):

text
Client probe-01 sending CONNECT
Client probe-01 received CONNACK (0)

这里的 (0) 对应接受连接。命令随后发送一条 QoS 0 消息并主动断开,所以不会等待 30 秒以演示心跳。需要检查字节字段时,可在明文测试连接的 Wireshark 中使用显示过滤器 mqtt,分别展开 CONNECT 的 Keep Alive 和 CONNACK 的返回码;TLS 加密流量不能直接按此方式读取 MQTT 字段。

心跳超时与建连失败的定位顺序

Keep Alive=30 时,如果 Broker 连续约 45 秒(1.5 倍间隔)收不到任何 MQTT 控制报文,就应关闭连接。Keep Alive=0 会关闭这一协议层的空闲超时机制,但不会阻止 TCP 或网络设备主动断线。

  1. TCP 尚未连接:先核对监听端口、网络路径和 TLS 配置,不必分析 MQTT 返回码。
  2. 已发 CONNECT 却无 CONNACK:查看 Broker 日志、报文格式和连接重置事件;格式错误可能导致直接断开。
  3. 收到拒绝码:按表检查版本、ID、凭证或权限;若先连接成功、空闲后才断开,再核对实际控制报文间隔与 Keep Alive。

排查记录应至少包含 Client ID、Clean Session、Keep Alive、CONNACK 的两项结果,以及最后收到的控制报文。这些证据可以区分建连失败、旧会话未恢复与连接后的心跳超时。

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

目录与阅读设置

阅读设置

17

记录一个想法

跟踪 CONNECT 建连过程

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

登录哪都通