本文介紹物聯網平臺可能返回給設備端的錯誤碼及說明。
公共錯誤碼
錯誤碼 | 原因 | 解決辦法 |
400 | 處理請求時出錯。 | 提交工單。 |
429 | 請求過于頻繁,觸發系統限流。 | 提交工單。 |
460 | 設備上報的數據為空,或參數格式錯誤、參數的數量超過限制等原因。 | 按照Alink協議下具體文檔中的數據格式,檢查參數信息。 |
500 | 系統發生未知異常。 | 提交工單。 |
5005 | 查詢產品信息失敗。 | 在物聯網平臺控制臺,查詢產品信息,核對ProductKey。 |
5244 | 查詢LoRaWAN類型產品的元信息失敗。 | 提交工單。 |
6100 | 查詢設備信息時,未查詢到指定設備信息。 | 在物聯網平臺控制臺的設備管理中,核對設備信息。 |
6203 | 解析Topic時失敗。 | 提交工單。 |
6250 | 查詢產品信息失敗。 | 在物聯網平臺控制臺的查詢產品信息,核對ProductKey。 |
6204 | 設備已被禁用,不能對設備進行操作。 | 在物聯網平臺控制臺的設備管理中,查看設備狀態。 |
6450 | 自定義/透傳格式數據經過腳本解析為Alink標準格式數據后,無method。 | 在物聯網平臺控制臺的日志服務中,或設備本地日志中,檢查設備上報的數據中是否有method參數。 |
6760 | 系統異常。 | 提交工單。 |
錯誤碼 | 原因 | 排查 |
26001 | 執行數據解析時,獲取的腳本內容為空。 | 在物聯網平臺控制臺,產品的數據解析頁簽下,確認腳本已提交。 說明 未提交的腳本不能被調用。 |
26002 | 腳本執行正常,但腳本內容有問題,如腳本中語法錯誤。 | 使用相同的數據測試腳本。查看具體的錯誤信息,修改腳本。建議在本地詳細的自驗后,再提交到物聯網平臺。 |
26006 | 腳本執行正常,腳本內容有誤。腳本中,要求有protocolToRawData和rawDataToProtocol這兩個服務。如果缺失,會報錯。 | 在物聯網平臺控制臺,產品的數據解析頁簽下,查詢腳本內容中protocolToRawData和rawDataToProtocol服務是否存在。 |
26007 | 腳本執行正常,但返回結果不符合格式要求。 腳本中,要求有protocolToRawData和rawDataToProtocol這兩個服務。protocolToRawData返回byte[]數組, rawDataToProtocol要求返回JSON對象。如果返回結果不符合這兩種格式,會報這個錯。 | 在物聯網平臺控制臺或在本地測試腳本,并查看返回結果的格式是否符合要求。 |
26010 | 請求過于頻繁,導致被限流。 | 提交工單。 |
錯誤碼 | 原因 | 排查 |
5159 | TSL校驗時,查詢屬性定義失敗。 | 提交工單。 |
5160 | TSL校驗時,查詢事件定義失敗。 | 提交工單。 |
5161 | TSL校驗時,查詢服務定義失敗。 | 提交工單。 |
6207 | 設備上報的Alink數據格式,或者調用腳本解析后返回的數據格式,不是JSON格式。 | 請參見設備屬性、事件、服務,查看對應數據格式,并按格式要求上報數據。 |
6300 | method不存在。TSL校驗時,設備上報的Alink(標準)格式數據,或自定義(透傳)格式數據經過腳本轉換后,沒有Alink協議要求的method參數。 | 在物聯網平臺控制臺的日志服務,或者設備的本地日志中,查看上報數據中是否有method參數。 |
6301 | TSL校驗時,發現定義的數據為array類型,但上報的數據不是array類型。 | 在物聯網平臺控制臺,產品的功能定義頁簽下,查看產品的TSL中對應數據格式,并按格式要求上報數據。 |
6302 | TSL校驗服務的入參時,發現缺少必需的參數。 | 在物聯網平臺控制臺,查看設備所屬產品的功能定義,查詢對應服務的入參,核對傳入的參數。 |
6306 | TSL校驗時,發現:
| 在物聯網平臺控制臺,查看設備所屬產品的功能定義,核對傳入的參數類型和取值范圍。 |
6307 | 傳入的參數不符合TSL中32位浮點數據的規范。TSL校驗時,發現:
| |
6308 | 傳入的參數不符合TSL中布爾類型數據的規范。TSL校驗時,發現:
| |
6310 | 傳入的參數不符合TSL中字符類型數據的規范。TSL校驗時,發現:
| |
6322 | 傳入的參數不符合TSL中64位浮點數據的規范。TSL校驗時,發現:
| |
6304 | TSL校驗時,發現傳入的參數在結構體中不存在。 | 在物聯網平臺控制臺,查看設備所屬產品的功能定義,核對傳入的參數類型。 |
6309 | 傳入的參數不符合TSL中枚舉類型數據的規范。 | |
6311 | 傳入的參數不符合TSL中日期類型數據的規范。TSL校驗時,發現:
| |
6312 | 傳入的參數不符合TSL中結構體類型數據的規范。TSL校驗時,發現:
| |
6320 | 查詢設備的TSL時,沒有查詢到設備的屬性信息。 | 在物聯網平臺控制臺,查看設備所屬產品的功能定義中是否存在該屬性。若不存在,需增加屬性定義。 |
6321 | 解析TSL時,發現屬性、事件或者服務的標識符為空。 | 提交工單。 |
6317 | TSL校驗時,發現TSL中缺少關鍵信息,如type,specs為空。 | 提交工單。 |
6324 | 傳入的數組類型的參數不符合規范。TSL校驗時,發現:
|
|
6325 | 傳入的數組類型參數中有不支持的元素類型。目前,數組中元素的類型只支持整型、32位浮點類型、64位浮點類型、字符串類型、結構體類型。 | 檢查傳入的數組元素類型是否是支持的類型。 |
6326 | TSL校驗時,檢查上報的數據中time字段格式時報錯。 | 請參見設備屬性、事件、服務,查看對應數據格式,并按格式要求上報數據。 |
6328 | TSL校驗時,發現傳入的參數不是數組類型。 | 在物聯網平臺控制臺,查看設備所屬產品的功能定義,核對傳入的對應參數是否是數組類型。 |
6318 | TSL解析時,系統異常。 | 提交工單。 |
6313 | ||
6329 | ||
6323 | ||
6316 | ||
6314 | ||
6301 |
設備接入Link SDK相關錯誤碼
設備身份注冊相關錯誤碼
直連設備身份注冊
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/sub/register
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/sub/register_reply
錯誤碼:460、5005、5244、500、6288、6100、6619、6292、6203
以下為設備身份注冊的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6288
設備動態注冊開關未打開。
在物聯網平臺控制臺,設備所屬的產品詳情頁,開啟設備動態注冊。
6619
設備已綁定到其它網關下。
在物聯網平臺控制臺,該子設備的詳情頁,查看該設備是否已綁定網關。
- 請求Topic:
直連設備一型一密動態注冊
錯誤碼:460、6250、6288、6600、6289、500、6292
以下為直連設備一型一密動態注冊的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6288
設備動態注冊開關未打開。
在物聯網平臺控制臺,設備所屬的產品詳情頁,開啟設備動態注冊。
6292
校驗簽名時,發現傳入的簽名方法不支持。
請使用設備身份注冊中signMethod支持的簽名方法。
6600
簽名校驗失敗。
請按照設備身份注冊中的簽名方法計算簽名,并校驗簽名。
6289
一型一密動態注冊直連設備時,發現設備已激活。
在物聯網平臺控制臺的設備管理中,查看該設備的狀態。
設備拓撲關系相關錯誤碼
添加設備拓撲關系
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/topo/add
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/topo/add_reply
錯誤碼:460、429、6402、6100、401、6204、6400、6203
以下為添加設備拓撲關系的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
401
添加拓撲關系時,校驗簽名信息失敗。
請按照管理拓撲關系中的簽名方法計算簽名,并校驗。
6402
網關與子設備是同一個設備。添加拓撲關系時,不能把當前網關作為子設備添加到當前網關下。
檢查添加的子設備信息,是否有子設備信息和網關信息一致。
6400
為網關添加的子設備數量超過限制。
請參見使用限制,查看相關限制,并在物聯網平臺控制臺,該網關設備的子設備管理頁簽下,查看已有子設備數量。
- 請求Topic:
刪除拓撲關系
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/topo/delete
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/topo/delete_reply
錯誤碼:460、429、6100、6401、6203
以下為刪除設備拓撲關系的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6401
檢查拓撲關系時,拓撲關系不存在。
在物聯網平臺控制臺設備管理,網關設備的設備詳情頁子設備管理頁簽中,查看子設備信息。
- 請求Topic:
獲取拓撲關系
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/topo/get
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/topo/get_reply
錯誤碼:460、429、500、6203
錯誤碼說明,請參見本文公共錯誤碼章節。
- 請求Topic:
網關上報發現子設備
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/list/found
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/list/found_reply
錯誤碼:460、500、6250、6280、6203
以下為特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6280
網關上報的子設備名稱不符合規范。設備名稱字符僅支持中文漢字、英文字母、數字和下劃線(_),長度范圍4~32個字符,一個中文漢字算兩個字符。
檢查上報的設備名稱是否符合規范。
- 請求Topic:
子設備上下線相關錯誤碼
子設備上線
接收消息的網關Topic:
/ext/session/${productKey}/${deviceName}/combine/login_reply
錯誤碼:460、429、6100、6204、6287、6401、500、9241、9240
子設備主動下線異常
接收消息的網關Topic:
/ext/session/${productKey}/${deviceName}/combine/logout_reply
錯誤碼:460、520、500
子設備被迫下線
接收消息的網關Topic:
/ext/error/${productKey}/${deviceName}
錯誤碼:427、521、522、6401
子設備發送消息失敗
接收消息的網關Topic:
/ext/error/${productKey}/${deviceName}
錯誤碼:520
網關代理子設備批量上報消息失敗
接收消息的網關Topic:
/sys/${productKey}/${deviceName}/proxy/batch_post_reply
錯誤碼:9242
以下為設子設備上、下線相關的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼 | 原因 | 排查 |
427 | 設備證書信息被其他設備使用,使設備被迫下線。 物聯網平臺僅以設備證書信息(productKey、deviceName、deviceSecret)來判斷設備。
|
|
428 | 單個網關下子設備數目超過最大值。 限制說明,請參見使用限制的網關與子設備。 | 請檢查網關設備下的子設備數量。 |
521 | 設備已被刪除。 | 在物聯網平臺控制臺的設備管理頁搜索設備,確認設備是否已被刪除。 |
522 | 設備已被禁用。 | 在物聯網平臺控制臺的設備管理頁查看設備狀態。 |
520 | 子設備會話錯誤。
| |
6287 | 按照產品或者設備的密鑰校驗簽名失敗。 | 請參見子設備上下線中的簽名方法計算簽名,并校驗。 |
1914 | 單個批量上下線請求中,包含的子設備數量超過限制(5個)。 | 檢查子設備批量上下線數量是否超過閾值。 |
1913 | 網關離線導致子設備被云端自動離線。 | 根據日志服務查詢網關離線原因。 |
9242 | 一個批量上報消息請求中,網關代理子設備批量上報的消息條數超出限制(50條)。 | 檢查子設備批量上報的消息條數是否超過閾值。 |
9241 | 網關代理子設備上線請求中,在線設備不能修改連接的設備類型。 連接的設備類型說明,請參見MQTT客戶端直連中的conntype。 | 檢查網關設備和子設備是否已在線。 |
9240 | 一個批量上下線請求中,狀態相關網關設備下子設備數量超出限制(10,000)。 | 檢查子設備批量上下線數量是否超過閾值。 |
設備屬性、事件、服務相關錯誤碼
設備上報屬性
透傳數據格式:
請求Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw
響應Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
Alink數據格式:
請求Topic:
/sys/${productKey}/${deviceName}/thing/event/property/post
響應Topic:
/sys/${productKey}/${deviceName}/thing/event/property/post_reply
錯誤碼:460、500、6250、6203、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007
以下為上報屬性的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6106
上報的屬性數據過多。設備一次上報的有效屬性個數不能超過200個。
在物聯網平臺控制臺,
中,或設備本地的日志中,檢查上報的屬性個數。設備上報事件
透傳數據格式:
請求Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw
響應Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
Alink格式數據:
默認模塊
請求Topic:
/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post
響應Topic:
/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post_reply
自定義模塊:
請求Topic:
/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post
響應Topic:
/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post_reply
錯誤碼:460、500、6250、6203、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007
錯誤碼說明,請參見本文公共錯誤碼章節。
網關批量上報子設備數據
透傳數據格式:
請求Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw
響應Topic:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
Alink格式數據:
請求Topic:
/sys/${productKey}/${deviceName}/thing/event/property/pack/post
響應Topic:
/sys/${productKey}/${deviceName}/thing/event/property/pack/post_reply
錯誤碼:460、6401、6106、6357、6356、6100、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007
以下為網關批量上報子設備數據失敗的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6401
拓撲關系不存在。
在物聯網平臺控制臺,網關設備的子設備管理頁簽下,確認其子設備信息。
6106
上報的屬性數據過多。設備一次上報的有效屬性個數不能超過200個。
在物聯網平臺控制臺,
中,或設備本地的日志中,檢查上報的屬性個數。6357
子設備數據過多。網關代替子設備上報數據,一次上報最多可包含20個子設備的數據。
查看設備本地日志中的上報數據。
6356
上報的事件數據過多。網關代替子設備上報數據,一次上報的事件個數不可超過200。
查看設備本地的日志中的上報數據。
設備期望屬性值相關錯誤碼
設備獲取期望屬性值
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/property/desired/get
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/property/desired/get_reply
。
錯誤碼:460、6104、6661、500
以下為設備期望屬性值操作失敗的特有錯誤碼說明,其他錯誤碼說明請參見公共錯誤碼章節。
錯誤碼
原因
排查
6104
請求中包含的屬性個數過多。一次請求可包含的屬性個數不能超過200個。
在物聯網平臺控制臺,
中,或者設備本地日志中,查看上報數據中的屬性個數。6661
查詢期望屬性失敗。系統異常。
提交工單排查。
- 請求Topic:
設備清空期望屬性值
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/property/desired/delete
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/property/desired/delete_reply
。
錯誤碼:460、6104、6661、500、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325
- 請求Topic:
設備標簽相關錯誤碼
設備上報標簽信息
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply
錯誤碼:460、6100
- 請求Topic:
設備刪除標簽信息
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/deviceinfo/delete
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply
錯誤碼:460、500
- 請求Topic:
獲取TSL模板相關錯誤碼
請求Topic:
/sys/${productKey}/${deviceName}/thing/dsltemplate/get
響應Topic:
/sys/${productKey}/${deviceName}/thing/dsltemplate/get_reply
錯誤碼:460、5159、5160、5161
設備請求升級包信息相關錯誤碼
請求Topic:
/sys/${productKey}/${deviceName}/thing/ota/firmware/get
響應Topic:
/sys/${productKey}/${deviceName}/thing/ota/firmware/get_reply
錯誤碼:429、9112、500
以下為設備請求升級包信息的特有錯誤碼,其他錯誤碼,請參見公共錯誤碼章節。
錯誤碼 | 原因 | 排查 |
9112 | 未查詢到指定的設備信息。 | 在物聯網平臺控制臺的設備管理中,確認設備信息是否正確。 |
設備請求配置信息相關錯誤碼
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/config/get
- 響應Topic:
/sys/${productKey}/${deviceName}/thing/config/get_reply
錯誤碼:460、500、6713、6710
以下為設備請求配置信息的特有錯誤碼,其他錯誤碼,請參見公共錯誤碼章節。
錯誤碼 | 原因 | 排查 |
6713 | 遠程配置服務不可用。該產品的遠程配置開關未打開。 | 在物聯網平臺控制臺, 中,打開該產品的遠程配置開關。 |
6710 | 未查詢到遠程配置信息。 | 在物聯網平臺控制臺, 中,查看是否為該產品編輯了遠程配置文件。 |
設備自定義任務相關錯誤碼
設備獲取自定義任務詳情
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/job/get
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/job/get_reply
。
錯誤碼:71012、71034、71035
- 請求Topic:
設備更新任務下作業狀態
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/job/update
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/job/update_reply
。
錯誤碼:71018、71019、71034、71035
- 請求Topic:
錯誤碼 | 原因 | 排查 |
71012 | 設備獲取任務詳情中,發起請求的數據格式不是JSON格式。 | 請參見獲取設備任務詳情,查看正確的數據格式,并按照數據格式上報請求。 |
71018 | 任務已處于以下任一狀態:
| 在物聯網平臺控制臺的 的任務列表中,確認目標任務的狀態。 |
71019 | 任務下作業的ID不存在。 | 在物聯網平臺控制臺的 頁面,進入目標任務的 頁簽,確認作業ID是否存在。 |
71034 | 任務下作業ID不屬于當前設備。 | 在物聯網平臺控制臺的 頁面,進入目標任務的 頁簽,確認當前設備是否包含該作業ID。 |
71035 |
| 在物聯網平臺控制臺的 頁面,進入目標任務的任務詳情頁面:
|
設備上傳文件相關錯誤碼
上傳文件的數據格式和參數說明,請參見文件上傳。
設備請求上傳文件
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init_reply
。
錯誤碼:78117、78123、78124、78125
- 請求Topic:
設備上傳文件分片
- 請求Topic:
/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send
。 - 響應Topic:
/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send_reply
。
錯誤碼:78118、78119、78120、78121、78122、78124、78125、78126
- 請求Topic:
錯誤碼 | 原因 | 排查 |
78117 | 設備請求上傳文件的大小超出最大限制(16 MB)。 | 確認待上傳文件大小是否符合要求。 |
78118 | 設備上傳文件分片的大小超出最大限制(128 KB)。 | 確認上傳文件的分片大小是否符合要求。詳細信息 ,請參見上傳文件。 |
78120 | 設備上傳文件分片的大小不滿足最小限制(256 B)。 | |
78119 | 設備上傳后續文件分片時的offset值,與實際已上傳到物聯網平臺云端的文件大小不一致。 | 確認設備上傳文件分片時的offset的值是否正確。 |
78121 | 設備上傳文件分片時,當前文件分片的文件完整性校驗失敗。 | 根據CRC算法校驗的錯誤信息,排查原因。 |
78122 | 設備上傳文件的任務不存在。 | 確認上傳文件的標識ID是否正確或存在。 |
78123 | 同名文件已存在。 | 確認設備端設置的文件處理策略,是否支持上傳同名文件。詳細信息 ,請參見上傳文件。 |
78124 | 文件上傳任務已經完成。 重要 針對已完成上傳的文件,設備端不能再進行上傳文件分片和取消文件上傳任務的操作。 | 確認物聯網平臺是否已存在上傳的文件,具體操作,請參見查看文件。 |
78125 | 文件完整性校驗失敗。 | 確認物聯網平臺云端計算的文件完整性校驗值,是否與設備上傳文件時的完整性校驗值相同。 |
78126 | 設備端并行上傳了文件的同一分片數據。 | 確認設備端是否收到當前分片數據的響應消息后,再發送的下一個分片數據。 |