为何mosquitto_sub 1.14.15无法连接MQTT而2.0.11可以？

问题场景 #

使用mosquitto_sub v1.14.15执行以下命令连接MQTT Broker：

mosquitto_sub -h <host_url> -p 8883 -t '#' -u <username> -P <pw> -d -i <myidentity>

返回错误输出：

Client myidentity sending CONNECT
Error: Unrecognised command 16

Error: A network protocol error occurred when communicating with the broker.

但使用mosquitto_sub v2.0.11执行相同命令可正常连接，初始连接输出如下：

Client myidentity sending CONNECT
Client myidentity received CONNACK (0)
Client myidentity sending SUBSCRIBE (Mid: 1, Topic: #, QoS: 0, Options: 0x00)
Client myidentity received SUBACK
Subscribed (mid: 1): 0

失败原因 #

错误中的“Unrecognised command 16”指向MQTT控制包类型16，对应MQTT 5.0的AUTH包。mosquitto_sub v1.14.15仅支持MQTT 3.1/3.1.1协议，不兼容MQTT 5.0特性。如果Broker默认启用MQTT 5.0，且在连接过程中触发了需要AUTH包的认证流程（比如多阶段认证），旧版本客户端因无法识别该包会直接报错断开。

调试方法 #

• 强制指定MQTT协议版本：在旧版命令中添加--protocol mqttv311或--protocol mqttv31参数，明确让客户端使用3.1.1/3.1协议，避免Broker尝试用MQTT 5.0交互
• 抓包分析：用tcpdump或Wireshark抓取8883端口的流量，确认Broker是否返回了类型为16的AUTH包
• 查看Broker日志：开启Broker的调试级日志，查看连接过程中的协议协商、认证步骤细节，定位是否因协议版本不匹配触发了不兼容的流程

Broker兼容配置（以Mosquitto Broker为例） #

• 限制协议版本：在Broker配置文件中添加protocol_version mqttv311，强制Broker仅支持MQTT 3.1.1协议，避免触发MQTT 5.0专属特性
• 简化认证流程：确保Broker的认证配置（如password_file）正确，无需依赖MQTT 5.0的AUTH包完成多阶段认证
• 开启多版本兼容：如果Broker支持，配置允许同时接受MQTT 3.1/3.1.1/5.0版本的连接，避免强制要求客户端使用高版本协议

内容的提问来源于stack exchange，提问作者Kris Schilling