如果設備通過MQTT協議接入物聯網平臺失敗,請根據錯誤碼排查問題。

阿里云物聯網平臺使用的是標準的MQTT協議。了解MQTT協議,請參見MQTT 3.1或3.1.1標準協議文檔MQTT 5.0標準協議文檔

服務端返回碼說明如下。

  • MQTT 3.1和3.1.1
    返回碼 返回信息 原因
    0 0x00 Connection Accepted 連接成功。
    1 0x01 Connection Refused, unacceptable protocol version 服務器不支持設備端請求的MQTT協議版本。
    2 0x02 Connection Refused, identifier rejected clientId參數格式錯誤,不符合物聯網平臺規定的格式。例如參數值超出長度限制、擴展參數格式錯誤等。
    3 0x03 Connection Refused, Server unavailable 網絡連接已建立成功,但MQTT服務不可用。
    4 0x04 Connection Refused, bad user name or password usernamepassword格式錯誤。
    5 0x05 Connection Refused, not authorized 設備未經授權。
  • MQTT 5.0
    返回碼 返回信息 原因
    0 0x00 Success 連接成功。
    128 0x80 Unspecified error 未指定錯誤。
    129 0x81 Malformed Packet 畸形報文。
    130 0x82 Protocol Error 協議錯誤。
    132 0x84 Unsupported Protocol Version 不支持的協議版本。
    136 0x88 Server unavailable 服務器不可用。
    137 0x89 Server busy 服務器繁忙。
    138 0x8A Banned 禁止訪問。
    140 0x8C Bad authentication method 錯誤驗證方法。
    141 0x8D Keep Alive timeout 保活超時。
    144 0x90 Topic Name invalid Topic名無效。
    147 0x93 Receive Maximum exceeded 超出接收最大值。
    148 0x94 Topic Alias invalid Topic別名無效。
    149 0x95 Packet too large 報文長度超出限制。
    150 0x96 Message rate too high 消息傳輸速率太高。
    151 0x97 Quota exceeded 超出限額。
    152 0x98 Administrative action 管理行為。
    153 0x99 Payload format invalid Payload格式無效。
    154 0x9A Retain not supported 不支持消息保留。
    155 0x9B QoS not supported 不支持的QoS。
    156 0x9C Use another server 使用另一臺服務器。
    157 0x9D Server moved 服務器被移除。
    158 0x9E Shared Subscription not supported 不支持的共享訂閱。
    159 0x9F Connection rate exceeded 超出連接速率。