全部產品

：常見錯誤碼

更新時間：Jun 30, 2024

本文介紹在配置C Link SDK的裝置接入功能時，常見錯誤。

Link SDK通過以下兩種渠道，表達建連失敗時的內部運行狀態。您可以通過內部運行狀態，瞭解失敗原因。

API的傳回值是int32_t的非正數整型，即狀態代碼，狀態代碼返回0表成功，其它值表示運行狀態。
- 使用retval = aiot_xxx_yyy()方式擷取傳回值。
- 所有傳回值唯一對應內部運行分支，詳情請參見aiot_state_api.h或aiot_xxx_api.h。
- 所有組件傳回值的範圍互不重疊，共同分別分布在0x0000 - 0xFFFF。
從SDK內部，調用您的日誌回呼函數。

以下為常見錯誤碼，完整的錯誤碼列表，請參見aiot_state_api.h。

MQTT接入

錯誤碼	說明
STATE_MQTT_CONNACK_RCODE_SERVER_UNAVAILABLE	MQTT伺服器拒絕提供串連，服務當前不可用。請稍後重試。
STATE_MQTT_CONNACK_RCODE_BAD_USERNAME_PASSWORD	串連時的使用者名稱或密碼非法。
STATE_MQTT_CONNACK_RCODE_NOT_AUTHORIZED	MQTT伺服器進行串連身分識別驗證失敗，登入密碼錯誤。請檢查裝置認證資訊是否正確。

HTTPS接入

錯誤碼	說明
STATE_HTTP_STATUS_LINE_INVALID	解析收到的HTTPS報文時，無法擷取有效關於狀態的程式碼。無法擷取HTTPS `StatusCode` 。
STATE_HTTP_READ_BODY_FINISHED	解析收到的HTTPS報文時，報文的Body部分已接收完畢，但沒有更多資料。
STATE_HTTP_AUTH_CODE_FAILED	HTTPS認證應答的StatusCode不是200，認證失敗。請檢查認證簽名是否正確。
STATE_HTTP_AUTH_NOT_FINISHED	未完成接收HTTPS認證應答接，認證失敗。
STATE_HTTP_AUTH_TOKEN_FAILED	HTTPS認證應答中，未能解析到Token，認證失敗。

網路層

錯誤碼	說明
STATE_PORT_NETWORK_DNS_FAILED	TCP網域名稱解析失敗，請檢查網域名稱或IP是否正確。
STATE_PORT_NETWORK_CONNECT_FAILED	TCP建立串連失敗。
STATE_PORT_TLS_INVALID_MAX_FRAGMENT	TLS報文最大長度設定為0，該設定非法，請檢查後重新設定。
STATE_PORT_TLS_INVALID_SERVER_CERT	TLS服務端認證配置錯誤，請檢查服務端認證是否正確。
STATE_PORT_TLS_INVALID_CLIENT_CERT	TLS裝置端認證配置錯誤，請檢查用戶端認證是否正確。
STATE_PORT_TLS_INVALID_CLIENT_KEY	TLS用戶端密鑰配置錯誤，請檢查用戶端密鑰是否正確。
STATE_PORT_TLS_DNS_FAILED	TLS網域名稱解析失敗，請檢查網域名稱或IP是否配置正確。
STATE_PORT_TLS_SOCKET_CREATE_FAILED	TLS Socket建立失敗。
STATE_PORT_TLS_SOCKET_CONNECT_FAILED	TLS Socket串連失敗。
STATE_PORT_TLS_INVALID_RECORD	SSL收到的資料包出錯，請檢查TLS幀資料的長度是否過小。