裝置端接收的錯誤碼 - IoT Platform

本文介紹物聯網平台可能返回給裝置端的錯誤碼及說明。

公用錯誤碼

表 1. 通用公用錯誤碼
錯誤碼	原因	解決辦法
400	處理請求時出錯。	提交工單。
429	請求過於頻繁，觸發系統限流。	提交工單。
460	裝置上報的資料為空白，或參數格式錯誤、參數的數量超過限制等原因。	按照Alink協議下具體文檔中的資料格式，檢查參數資訊。
500	系統發生未知異常。	提交工單。
5005	查詢產品資訊失敗。	在物聯網平台控制台，查詢產品資訊，核對ProductKey。
5244	查詢LoRaWAN類型產品的元資訊失敗。	提交工單。
6100	查詢裝置資訊時，未查詢到指定裝置資訊。	在物聯網平台控制台的裝置管理中，核對裝置資訊。
6203	解析Topic時失敗。	提交工單。
6250	查詢產品資訊失敗。	在物聯網平台控制台的查詢產品資訊，核對ProductKey。
6204	裝置已被禁用，不能對裝置進行操作。	在物聯網平台控制台的裝置管理中，查看裝置狀態。
6450	自訂/透傳格式資料經過指令碼解析為Alink標準格式資料後，無method。	在物聯網平台控制台的Log Service中，或裝置本地日誌中，檢查裝置上報的資料中是否有method參數。
6760	系統異常。	提交工單。

表 2. 資料解析公用錯誤碼
錯誤碼	原因	排查
26001	執行資料解析時，擷取的指令碼內容為空白。	在物聯網平台控制台，產品的資料解析頁簽下，確認指令碼已提交。說明未提交的指令碼不能被調用。
26002	指令碼執行正常，但指令碼內容有問題，如指令碼中語法錯誤。	使用相同的資料測試指令碼。查看具體的錯誤資訊，修改指令碼。建議在本地詳細的自驗後，再提交到物聯網平台。
26006	指令碼執行正常，指令碼內容有誤。指令碼中，要求有protocolToRawData和rawDataToProtocol這兩個服務。如果缺失，會報錯。	在物聯網平台控制台，產品的資料解析頁簽下，查詢指令碼內容中protocolToRawData和rawDataToProtocol服務是否存在。
26007	指令碼執行正常，但返回結果不符合格式要求。指令碼中，要求有protocolToRawData和rawDataToProtocol這兩個服務。protocolToRawData返回byte[]數組， rawDataToProtocol要求返回JSON對象。如果返回結果不符合這兩種格式，會報這個錯。	在物聯網平台控制台或在本地測試指令碼，並查看返回結果的格式是否符合要求。
26010	請求過於頻繁，導致被限流。	提交工單。

表 3. TSL公用錯誤碼
錯誤碼	原因	排查
5159	TSL校正時，查詢屬性定義失敗。	提交工單。
5160	TSL校正時，查詢事件定義失敗。	提交工單。
5161	TSL校正時，查詢服務定義失敗。	提交工單。
6207	裝置上報的Alink資料格式，或者呼叫指令碼解析後返回的資料格式，不是JSON格式。	請參見裝置屬性、事件、服務，查看對應資料格式，並按格式要求上報資料。
6300	method不存在。TSL校正時，裝置上報的Alink（標準）格式資料，或自訂（透傳）格式資料經過指令碼轉換後，沒有Alink協議要求的method參數。	在物聯網平台控制台的Log Service，或者裝置的本地日誌中，查看上報資料中是否有method參數。
6301	TSL校正時，發現定義的資料為array類型，但上報的資料不是array類型。	在物聯網平台控制台，產品的功能定義頁簽下，查看產品的TSL中對應資料格式，並按格式要求上報資料。
6302	TSL校正服務的入參時，發現缺少必要參數。	在物聯網平台控制台，查看裝置所屬產品的功能定義，查詢對應服務的入參，核對傳入的參數。
6306	TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的參數取值範圍不符合功能定義時設定的參數範圍。	在物聯網平台控制台，查看裝置所屬產品的功能定義，核對傳入的參數類型和取值範圍。
6307	傳入的參數不符合TSL中32位浮點數據的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的參數取值範圍不符合功能定義時設定的參數範圍。
6308	傳入的參數不符合TSL中布爾類型資料的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的參數取值範圍不符合功能定義時設定的參數範圍。
6310	傳入的參數不符合TSL中字元類型資料的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的字元類型的參數長度超過限制。
6322	傳入的參數不符合TSL中64位浮點數據的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的參數取值範圍不符合功能定義時設定的參數範圍。
6304	TSL校正時，發現傳入的參數在結構體中不存在。	在物聯網平台控制台，查看裝置所屬產品的功能定義，核對傳入的參數類型。
6309	傳入的參數不符合TSL中枚舉類型資料的規範。
6311	傳入的參數不符合TSL中日期類型資料的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。傳入的字元類型不是UTC時間戳記的字元格式設定。
6312	傳入的參數不符合TSL中結構體類型資料的規範。TSL校正時，發現：傳入的參數類型和TSL中定義的類型不一致。結構體類型中參數的個數和TSL中定義不一致。
6320	查詢裝置的TSL時，沒有查詢到裝置的屬性資訊。	在物聯網平台控制台，查看裝置所屬產品的功能定義中是否存在該屬性。若不存在，需增加屬性定義。
6321	解析TSL時，發現屬性、事件或者服務的標識符為空白。	提交工單。
6317	TSL校正時，發現TSL中缺少關鍵資訊，如type，specs為空白。	提交工單。
6324	傳入的數群組類型的參數不符合規範。TSL校正時，發現：傳入的數群組類型的參數不符合TSL定義。數組中參數個數超過了TSL中定義的最大個數。	在物聯網平台控制台的產品詳情中，查看裝置所屬產品的功能定義，檢查對應數組的定義。查看裝置上報的日誌，檢查裝置上報的資料中數組內元素的個數。
6325	傳入的數群組類型參數中有不支援的元素類型。目前，數組中元素的類型只支援整型、32位浮點類型、64位浮點類型、字串類型、結構體類型。	檢查傳入的數組元素類型是否是支援的類型。
6326	TSL校正時，檢查上報的資料中time欄位格式時報錯。	請參見裝置屬性、事件、服務，查看對應資料格式，並按格式要求上報資料。
6328	TSL校正時，發現傳入的參數不是數群組類型。	在物聯網平台控制台，查看裝置所屬產品的功能定義，核對傳入的對應參數是否是數群組類型。
6318	TSL解析時，系統異常。	提交工單。
6313
6329
6323
6316
6314
6301

裝置身份註冊相關錯誤碼

直連裝置身份註冊

請求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	裝置已綁定到其它網關下。	在物聯網平台控制台，該子裝置的詳情頁，查看該裝置是否已綁定網關。

直連裝置一型一密動態註冊

錯誤碼：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：/sys/${productKey}/${deviceName}/thing/topo/delete
- 響應Topic：/sys/${productKey}/${deviceName}/thing/topo/delete_reply
錯誤碼：460、429、6100、6401、6203
以下為刪除裝置拓撲關係的特有錯誤碼說明，其他錯誤碼說明請參見公用錯誤碼章節。
錯誤碼
原因
排查
6401
檢查拓撲關係時，拓撲關係不存在。
在物聯網平台控制台裝置管理，網關裝置的裝置詳情頁子裝置管理頁簽中，查看子裝置資訊。
擷取拓撲關係
- 請求Topic：/sys/${productKey}/${deviceName}/thing/topo/get
- 響應Topic：/sys/${productKey}/${deviceName}/thing/topo/get_reply
錯誤碼：460、429、500、6203
錯誤碼說明，請參見本文公用錯誤碼章節。

網關上報發現子裝置

請求Topic：/sys/${productKey}/${deviceName}/thing/list/found
響應Topic：/sys/${productKey}/${deviceName}/thing/list/found_reply

錯誤碼：460、500、6250、6280、6203

以下為特有錯誤碼說明，其他錯誤碼說明請參見公用錯誤碼章節。

錯誤碼	原因	排查
6280	網關上報的子裝置名稱不符合規範。裝置名稱字元僅支援中文漢字、英文字母、數字和底線（_），長度範圍4~32個字元，一個中文漢字算兩個字元。	檢查上報的裝置名稱是否符合規範。

子裝置上下線相關錯誤碼

子裝置上線
接收訊息的網關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）來判斷裝置。多個裝置上燒錄了相同的裝置認證。裝置端網路或電源不穩定，發生了瞬間斷網或斷電重連。這種情況下，裝置與物聯網平台是串連的，不影響裝置使用。	在物聯網平台控制台裝置的裝置詳情頁，查看裝置的上線時間，以此判斷是否有其他裝置使用相同的裝置認證接入物聯網平台。排查網路環境是否穩定延遲測試的步驟，請參見物聯網平台發送訊息比較慢，存在逾時情況，為什嗎？在裝置端ping伺服器位址通過網路診斷工具檢測時延
428	單個網關下子裝置數目超過最大值。限制說明，請參見使用限制的網關與子裝置。	請檢查網關裝置下的子裝置數量。
521	裝置已被刪除。	在物聯網平台控制台的裝置管理頁搜尋裝置，確認裝置是否已被刪除。
522	裝置已被禁用。	在物聯網平台控制台的裝置管理頁查看裝置狀態。
520	子裝置會話錯誤。子裝置會話不存在，可能子裝置沒有上線，也可能已經被下線。子裝置會話線上，但是並不是通過當前網關會話上線的。	在物聯網平台控制台的裝置管理頁查看裝置狀態。
6287	按照產品或者裝置的密鑰校正簽名失敗。	請參見子裝置上下線中的簽名方法計算簽名，並校正。
1914	單個批量上下線請求中，包含的子裝置數量超過限制（5個）。	檢查子裝置批量上下線數量是否超過閾值。
1913	網關離線導致子裝置被雲端自動離線。	根據Log Service查詢網關離線原因。
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個。	在物聯網平台控制台，監控營運 > Log Service中，或裝置本地的日誌中，檢查上報的屬性個數。

裝置上報事件
- 透傳資料格式：
  - 請求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個。	在物聯網平台控制台，監控營運 > Log Service中，或裝置本地的日誌中，檢查上報的屬性個數。
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個。	在物聯網平台控制台，監控營運 > Log Service中，或者裝置本地日誌中，查看上報資料中的屬性個數。
6661	查詢期望屬性失敗。系統異常。	提交工單排查。

裝置清空期望屬性值
- 請求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：/sys/${productKey}/${deviceName}/thing/deviceinfo/update
- 響應Topic：/sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply
錯誤碼：460、6100
裝置刪除標籤資訊
- 請求Topic：/sys/${productKey}/${deviceName}/thing/deviceinfo/delete
- 響應Topic：/sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply
錯誤碼：460、500

擷取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	未查詢到遠程配置資訊。	在物聯網平台控制台，監控營運 > 遠程配置中，查看是否為該產品編輯了遠程設定檔。