Utilice los códigos de error MQTT de este tema para diagnosticar y resolver fallos de conexión de dispositivos en IoT Platform.
IoT Platform utiliza el protocolo MQTT estándar. Para obtener más información, consulte la especificación MQTT 3.1 y 3.1.1 y la especificación MQTT 5.0.
A continuación se listan los códigos de retorno del servidor para las conexiones MQTT.
-
MQTT 3.1 y 3.1.1
Código de retorno
Mensaje de retorno
Causa
0
0x00 Connection Accepted
La conexión se estableció correctamente.
1
0x01 Connection Refused, unacceptable protocol version
El servidor no admite la versión del protocolo MQTT solicitada por el dispositivo.
2
0x02 Connection Refused, identifier rejected
El parámetro clientId no es válido o no cumple con el formato especificado por IoT Platform. Por ejemplo, el valor excede el límite de longitud o un parámetro extendido tiene un formato incorrecto.
3
0x03 Connection Refused, Server unavailable
La conexión de red se estableció, pero el servicio MQTT no está available.
4
0x04 Connection Refused, bad user name or password
El parámetro username o password no es válido.
5
0x05 Connection Refused, not authorized
El dispositivo no está autorizado.
-
MQTT 5.0
Código de retorno
Mensaje de retorno
Causa
0
0x00 Success
La conexión se estableció correctamente.
128
0x80 Unspecified error
Ocurrió un error no especificado.
129
0x81 Malformed Packet
Se recibió un paquete mal formado.
130
0x82 Protocol Error
Ocurrió un error de protocolo.
132
0x84 Unsupported Protocol Version
La versión del protocolo no es compatible.
136
0x88 Server unavailable
El servidor no está available.
137
0x89 Server busy
El servidor está ocupado.
138
0x8A Banned
El acceso está prohibido.
140
0x8C Bad authentication method
El método de autenticación no es válido.
141
0x8D Keep Alive timeout
Ocurrió un tiempo de espera agotado de keepalive.
144
0x90 Topic Name invalid
El nombre del tema no es válido.
147
0x93 Receive Maximum exceeded
Se excedió el número máximo de mensajes recibidos.
148
0x94 Topic Alias invalid
El alias del tema no es válido.
149
0x95 Packet too large
La longitud del paquete excede el límite.
150
0x96 Message rate too high
La tasa de transmisión de mensajes es demasiado alta.
151
0x97 Quota exceeded
Se excedió la cuota.
152
0x98 Administrative action
Ocurrió una acción administrativa.
153
0x99 Payload format invalid
El formato de la carga útil no es válido.
154
0x9A Retain not supported
La retención de mensajes no es compatible.
155
0x9B QoS not supported
El nivel de Calidad de Servicio (QoS) no es compatible.
156
0x9C Use another server
Utilice otro servidor.
157
0x9D Server moved
El servidor se ha movido.
158
0x9E Shared Subscription not supported
Las suscripciones compartidas no son compatibles.
159
0x9F Connection rate exceeded
Se excedió la tasa de conexiones.