HiveMQ集群连接异常：开发板返回CONNACK 5，桌面客户端正常

CONNACK错误码5（Not authorized）明确表示HiveMQ Broker拒绝了客户端的连接请求，核心原因是身份验证未通过。既然MQTTX能正常连接，说明Broker的授权配置本身无问题，问题出在开发板连接请求与MQTTX的差异上，以下是针对性排查步骤：

1. 核对用户名/密码的完整性与格式 #

• 排查开发板AT命令中传递的用户名、密码是否存在隐式错误：比如复制粘贴时带入了换行符、空格，或者特殊字符未按AT命令要求转义（部分模块要求参数用双引号包裹）。
• 直接使用MQTTX中验证有效的用户名/密码，手动输入到开发板配置中，避免复制粘贴的隐式问题。

2. 检查SSL连接时的身份验证细节 #

• 确认HiveMQ是否启用了双向SSL认证：虽然你提到MQTTX能正常连接，但部分MQTT客户端默认会忽略客户端证书要求，而开发板的AT命令可能未配置对应的客户端证书/密钥，导致Broker在SSL握手后拒绝授权。
• 临时测试：关闭HiveMQ的SSL双向认证（修改config.xml中的SSL配置），或让开发板的AT命令跳过证书验证（若支持该参数），验证是否能正常连接。

3. 对比ClientID的差异 #

• 虽然Broker默认允许任意ClientID，但部分模块生成的ClientID可能包含特殊字符（如非ASCII字符、过长字符串），导致Broker解析异常触发授权拒绝。直接使用MQTTX中使用的ClientID在开发板上测试。

4. 查看HiveMQ日志定位具体原因 #

• 查看HiveMQ的日志文件（默认路径./log/hivemq.log），日志中会详细记录每个错误码5的触发原因，比如“invalid password”“unknown username”“client lacks connect permission”等，这是最直接的排查依据。

5. 验证CONNECT报文的参数完整性 #

• 虽然你确认未加密的CONNECT格式无误，但AT命令封装SSL发送时，可能存在字节流截断、编码错误（如用户名/密码字段的UTF-8编码异常），导致Broker无法正确解析身份信息。可以通过抓包工具（如Wireshark）抓取开发板的SSL连接报文，解密后对比MQTTX的CONNECT报文内容是否完全一致。

6. 临时测试非SSL连接 #

• 修改HiveMQ配置，开启1883未加密端口，让开发板使用非SSL连接测试：
  • 若连接成功，说明问题出在SSL连接时的身份参数传递环节；
  • 若仍返回错误码5，说明身份验证参数本身存在问题，与SSL无关。

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