Use os códigos de erro MQTT deste tópico para diagnosticar e resolver falhas de conexão de dispositivos no IoT Platform.
O IoT Platform usa o protocolo MQTT padrão. Para obter mais informações, consulte a especificação MQTT 3.1 e 3.1.1 e a especificação MQTT 5.0.
As tabelas a seguir listam os códigos de retorno do servidor para conexões MQTT.
-
MQTT 3.1 e 3.1.1
Código de retorno
Mensagem de retorno
Causa
0
0x00 Connection Accepted
Conexão estabelecida com sucesso.
1
0x01 Connection Refused, unacceptable protocol version
O servidor não oferece suporte à versão do protocolo MQTT solicitada pelo dispositivo.
2
0x02 Connection Refused, identifier rejected
O parâmetro clientId é inválido ou não está em conformidade com o formato especificado pelo IoT Platform. Por exemplo, o valor excede o limite de comprimento ou um parâmetro estendido tem formato incorreto.
3
0x03 Connection Refused, Server unavailable
A conexão de rede foi estabelecida, mas o serviço MQTT está indisponível.
4
0x04 Connection Refused, bad user name or password
O parâmetro username ou password é inválido.
5
0x05 Connection Refused, not authorized
O dispositivo não tem autorização.
-
MQTT 5.0
Código de retorno
Mensagem de retorno
Causa
0
0x00 Success
Conexão estabelecida com sucesso.
128
0x80 Unspecified error
Ocorreu um erro não especificado.
129
0x81 Malformed Packet
Pacote malformado recebido.
130
0x82 Protocol Error
Ocorreu um erro de protocolo.
132
0x84 Unsupported Protocol Version
Versão do protocolo sem suporte.
136
0x88 Server unavailable
Servidor indisponível.
137
0x89 Server busy
Servidor ocupado.
138
0x8A Banned
Acesso proibido.
140
0x8C Bad authentication method
Método de autenticação inválido.
141
0x8D Keep Alive timeout
Tempo limite de keepalive atingido.
144
0x90 Topic Name invalid
Nome do tópico inválido.
147
0x93 Receive Maximum exceeded
Número máximo de mensagens recebidas excedido.
148
0x94 Topic Alias invalid
Alias do tópico inválido.
149
0x95 Packet too large
Comprimento do pacote excede o limite permitido.
150
0x96 Message rate too high
Taxa de transmissão de mensagens muito alta.
151
0x97 Quota exceeded
Cota excedida.
152
0x98 Administrative action
Ação administrativa executada.
153
0x99 Payload format invalid
Formato do payload inválido.
154
0x9A Retain not supported
Retenção de mensagens sem suporte.
155
0x9B QoS not supported
Nível de Qualidade de Serviço (QoS) sem suporte.
156
0x9C Use another server
Use outro servidor.
157
0x9D Server moved
Servidor movido.
158
0x9E Shared Subscription not supported
Assinaturas compartilhadas sem suporte.
159
0x9F Connection rate exceeded
Taxa de conexão excedida.