如果设备通过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是正确的UTF-8字符串,但服务器不支持。
    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 超出连接速率。