Azure IoT Hub设备MQTT推送失败，连接被关闭求助

核心原因推测 #

1. MQTT主题格式错误 #

Azure IoT Hub对遥测消息的MQTT主题有严格格式要求：必须是devices/{device-id}/messages/events/（可附加属性，比如devices/{device-id}/messages/events/{property-name}={property-value}&...）。如果嵌入式设备或mosquitto_pub使用了错误主题（比如遗漏events段、拼写错误、设备ID格式不匹配），IoT Hub会直接断开连接，无额外错误提示。

2. 消息QoS设置不兼容 #

Azure IoT Hub仅支持遥测消息的QoS 0或QoS 1。若设备或mosquitto_pub设置为QoS 2，会触发IoT Hub拒绝并断开连接。

3. SAS令牌权限不足 #

生成SAS令牌时，必须包含iothub.send权限。如果令牌仅拥有iothub.connect和iothub.receive权限，发送遥测时会触发权限校验失败，导致连接断开。

4. 消息格式或大小不符合要求 #

• IoT Hub要求遥测消息的Payload必须是合法UTF-8编码字符串，若二进制数据未转成Base64直接发送，会触发错误断连。
• 单条遥测消息默认大小限制为256KB，超出会被拒绝并断开连接。

5. MQTT连接参数不匹配 #

• 客户端ID必须与Azure IoT Hub中注册的设备ID完全一致（区分大小写），否则发送遥测时会触发身份校验失败。
• Clean Session标志需设为true，避免遗留会话导致的冲突。

针对性解决办法 #

1. 修正MQTT主题 #

确保发送遥测的主题严格符合格式，mosquitto_pub测试命令示例：

mosquitto_pub -h <IoT Hub名称>.azure-devices.net -p 8883 --cafile ./DigiCertGlobalRootG2.crt.pem -i <设备ID> -u <IoT Hub名称>.azure-devices.net/<设备ID>/api-version=2021-04-12 -P "<SAS令牌>" -t "devices/<设备ID>/messages/events/" -m '{"temperature":25}'

若需附加属性，主题格式示例：

devices/<设备ID>/messages/events/$.ct=application/json&$.ce=utf-8

2. 调整QoS设置 #

将设备或mosquitto_pub的QoS设为0或1，mosquitto_pub可通过-q 1参数指定：

mosquitto_pub ... -q 1 -t "devices/<设备ID>/messages/events/" -m '{"temperature":25}'

3. 重新生成带正确权限的SAS令牌 #

使用Azure CLI生成包含iothub.send权限的令牌：

az iot hub generate-sas-token --hub-name <IoT Hub名称> --device-id <设备ID> --policy-name iothubowner --duration 3600

4. 校验消息格式和大小 #

• 将二进制数据转成Base64编码后发送，确保Payload为UTF-8字符串。
• 拆分超过256KB的消息，分批次发送。

5. 核对连接参数 #

• 确认客户端ID与IoT Hub注册的设备ID完全一致（区分大小写）。
• 将Clean Session设置为true，重新建立连接。

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