错误排查

如果设备通过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	username或password格式错误。
  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	超出连接速率。