本文介绍在配置C Link SDK的设备接入功能时,常见错误。

Link SDK通过以下两种渠道,表达建连失败时的内部运行状态。您可以通过内部运行状态,了解失败原因。

  • API的返回值。
  • 从SDK内部,调用您的日志回调函数。

以下为常见错误码,完整的错误码列表,请参见aiot_state_api.h

MQTT接入

错误码 说明
STATE_MQTT_CONNACK_RCODE_SERVER_UNAVAILABLE -0x0303 MQTT服务器拒绝提供连接, 服务当前不可用。请稍后重试,或提交工单
STATE_MQTT_CONNACK_RCODE_BAD_USERNAME_PASSWORD -0x0304 连接时的用户名或密码非法。请提交工单
STATE_MQTT_CONNACK_RCODE_NOT_AUTHORIZED -0x0305 MQTT服务器进行连接身份验证失败,登录密码错误。请检查设备认证信息是否正确。

HTTPS接入

错误码 说明
STATE_HTTP_STATUS_LINE_INVALID -0x0401 解析收到的HTTPS报文时,无法获取有效的关于状态的代码行。无法获取HTTPS StatusCode提交工单
STATE_HTTP_READ_BODY_FINISHED -0x0402 解析收到的HTTPS报文时,报文的Body部分已接收完毕,但没有更多数据。请提交工单
STATE_HTTP_AUTH_CODE_FAILED -0x0404 HTTPS认证应答的StatusCode不是200,认证失败。请检查认证签名是否正确。
STATE_HTTP_AUTH_NOT_FINISHED -0x0405 未完成接收HTTPS认证应答接,认证失败。请提交工单
STATE_HTTP_AUTH_TOKEN_FAILED -0x0406 HTTPS认证应答中,未能解析到Token,认证失败。请提交工单

网络层

错误码 说明
STATE_PORT_NETWORK_DNS_FAILED -0x0F05 TCP域名解析失败,请检查域名或IP是否正确。
STATE_PORT_NETWORK_CONNECT_FAILED -0x0F0C TCP建立连接失败,请提交工单
STATE_PORT_TLS_INVALID_MAX_FRAGMENT -0x0F0B TLS报文最大长度设置为0,该设置非法,请检查后重新设置。
STATE_PORT_TLS_INVALID_SERVER_CERT -0x0F14 TLS服务端证书配置错误,请检查服务端证书是否正确。
STATE_PORT_TLS_INVALID_CLIENT_CERT -0x0F15 TLS设备端证书配置错误,请检查客户端证书是否正确。
STATE_PORT_TLS_INVALID_CLIENT_KEY -0x0F16 TLS客户端密钥配置错误,请检查客户端密钥是否正确。
STATE_PORT_TLS_DNS_FAILED -0x0F17 TLS域名解析失败,请检查域名或IP是否配置正确。
STATE_PORT_TLS_SOCKET_CREATE_FAILED -0x0F18 TLS Socket创建失败,请提交工单
STATE_PORT_TLS_SOCKET_CONNECT_FAILED -0x0F19 TLS Socket连接失败,请提交工单
STATE_PORT_TLS_INVALID_RECORD -0x0F1A SSL收到的数据包出错,请检查TLS帧数据的长度是否过小。