為方便進行問題定位，本文為您介紹語音識別業務中詳細的錯誤碼信息。
錯誤碼
識別成功
錯誤碼 | 錯誤信息 | 描述 |
0 | SUCCESS | 成功 |
配置或參數錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方案 |
240999 | DEFAULT_ERROR | 內部默認錯誤。 | 內部錯誤，請重試。 |
240001 | NUI_CONFIG_INVALID | 配置文件錯誤。 | 配置文件錯誤，請確認傳入的資源路徑內是否有資源文件。如果是Android平臺，請參考代碼樣例主動使用copyAssets接口。 |
240002 | ILLEGAL_PARAM | 非法參數。 | 請確認傳入的格式是否正確，包括字段類型，值范圍限制。 |
240003 | ILLEGAL_INIT_PARAM | 初始化參數非法。 | 請確認初始化參數格式錯誤或缺少必須字段。 |
240004 | NECESSARY_PARAM_LACK | 缺少必須參數。 | 請確認接口調用時的必須參數。 |
240005 | NULL_PARAM_ERROR | 參數為空。 | 確認參數是否為空。 |
240006 | NULL_LISTENER_ERROR | 未定義事件回調。 | 確認回調事件是否正確賦值。 |
240007 | NULL_DIALOG_ERROR | 無有效對話實例，一般在內部狀態錯誤時發生。 | 請確認接口調用前是否為正確狀態，可使用cancel接口恢復idle狀態。 |
240008 | NULL_ENGINE_ERROR | 無有效引擎實例，請檢查是否初始化成功。 | 請確認是否初始化成功。 |
240009 | ILLEGAL_DATA | 傳入音頻數據地址或長度非法。 | 請確認傳入的數據長度值。 |
SDK狀態錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方案 |
240010 | ILLEGAL_REENTRANT | 退出后調用SDK接口。 | 不影響功能時可忽略。 |
240011 | SDK_NOT_INIT | SDK未正確初始化。 | 確認初始化返回值正確再進行其他接口使用。 |
240012 | SDK_ALREADY_INIT | 重復調用SDK初始化接口。 | 確認初始化調用邏輯。 |
240013 | DIALOG_INVALID_STATE | 內部對話狀態錯誤。 | 請閱讀SDK流程圖，確認是否在錯誤狀態下調用接口。 |
240014 | STATE_INVALID | SDK內部狀態錯誤。 | 請閱讀SDK流程圖，確認是否在錯誤狀態下調用接口。 |
240015 | ILLEGAL_FUNC_CALL | 該模式無法調用接口。 | 請確認接口調用是否合理。 |
系統調用錯誤
錯誤碼 | 錯誤信息 | 描述 | 解決方法 |
240020 | MEM_ALLOC_ERROR | 內存分配錯誤。 | 檢查內存是否不足。 |
240021 | FILE_ACCESS_FAIL | 文件訪問錯誤。 | 檢查文件讀寫權限是否提供。 |
240022 | CREATE_DIR_ERROR | 創建目錄錯誤。 | 檢查是否有寫權限。 |
SDK內部調用錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240030 | CREATE_NUI_ERROR | 引擎創建失敗。 | 創建實例失敗，一般為系統資源不足。 |
240031 | TEXT_DIALOG_START_FAIL | 發起文本理解失敗。 | 文本轉語義理解失敗，請檢查網絡連接或URL以及Token等信息是否有效。 |
240032 | TEXT_CANCEL_START_FAIL | 取消文本理解失敗。 | 可忽略。 |
240033 | WUW_DUPLICATE | 動態喚醒詞重復。 | 可忽略。 |
本地引擎調用錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240040 | CEI_INIT_FAIL | 本地引擎初始化失敗。 | 請確認本地引擎的模型是否有效，目錄是否可讀寫。 |
240041 | CEI_SET_PARAM_FAIL | 引擎參數設置失敗。 | 可忽略。 |
240042 | CEI_COMPILE_GRAMMER_FAIL | 語法編譯失敗。 | 可忽略。 |
240043 | CEI_STOP_FAIL | 停止識別失敗。 | 可忽略。 |
240044 | CEI_CANCEL_FAIL | 取消識別失敗。 | 可忽略。 |
240045 | CEI_UNLOAD_KWS_FAIL | 取消喚醒詞失敗。 | 可忽略。 |
240046 | GET_WUW_ERROR | 獲取喚醒詞失敗。 | 可忽略。 |
音頻錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240050 | SELECT_RECORDER_ERROR | 選擇音頻設備錯誤。 | 內部錯誤，請重試。 |
240051 | UPDATE_AUDIO_ERROR | 推送音頻錯誤，一般為輸入音頻長度大于所需音頻。 | 確認推送的音頻長度是否非法。 |
240052 | MIC_ERROR | 連續2s未獲取到音頻。 | 請確認在音頻數據回調中是否正確提供所需長度的音頻。 |
調用超時錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240080 | ENGINE_INIT_TIMEOUT | 初始化引擎超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240081 | SET_PARAM_TIMEOUT | 設置參數超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240082 | SET_WUW_TIMEOUT | 設置喚醒詞超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240083 | SELECT_RECORDER_TIMEOUT | 選擇錄音設備超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240084 | STOP_TIMEOUT | 結束對話超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240085 | ASR_ENGINE_STOP_TIMEOUT | 結束引擎超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240086 | UNLOAD_DYNAMIC_WUW_TIMEOUT | 取消動態喚醒詞超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240087 | ADD_DYNAMIC_WUW_TIMEOUT | 增加動態喚醒詞超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240100 | WAIT_TIMEOUT | 引擎接口調用超時。 | 內部服務錯誤，需要客戶端進行重試。 |
240101 | HANDLE_API_TIMEOUT | API層接口調用超時。 | 內部服務錯誤，需要客戶端進行重試。 |
網絡錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240060 | CREATE_DA_REQUEST_ERROR | 創建對話助手實例失敗。 | 可忽略。 |
240061 | START_DA_REQUEST_ERROR | 發起對話助手請求失敗。 | 可忽略。 |
240062 | DEFAULT_NLS_ERROR | 服務端發生錯誤。說明該錯誤同時包含服務端返回錯誤內容，具體請參見服務端錯誤碼。 | 請參考服務端返回碼進一步定位。 |
240063 | SSL_ERROR | 創建SSL實例錯誤。 | 內部服務錯誤，需要客戶端進行重試。 |
240064 | SSL_CONNECT_FAILED | SSL連接失敗。 | 連接異常，請檢查服務URL或者本地網絡連接是否正常。 |
240065 | HTTP_CONNECT_FAILED | HTTP連接失敗。 | 服務連接錯誤，可通過日志文件查看HTTP返回值確認原因。 |
240066 | DNS_FAILED | DNS解析失敗。 | 請檢查本地網絡是否正常，DNS服務是否正常。 |
240067 | CONNECT_FAILED | socket連接失敗。 | 檢查網絡連接。 |
240068 | SERVER_NOT_ACCESS | 服務端無法訪問。 | 請檢查Token是否過期或者URL是否正確。 |
240069 | SOCKET_CLOSED | socket已關閉。 | 內部服務錯誤，需要客戶端進行重試。 |
240070 | AUTH_FAILED | 鑒權失敗。 | 請檢查是否提供正確的ak_secret，ak_id，app_key，sdk_code，device_id等信息，以及確認是否開通足夠配額。 |
240071 | HTTPDNS_FAILED | 使用客戶端傳入的IP連接失敗。 | 如果使用直接傳入IP進行訪問，請確認IP是否可訪問。 |
240072 | HTTP_SEND_FAILED | 文件轉寫HTTP發送失敗。 | 確認網絡連接是否正常。 |
240073 | HTTP_RECEIVE_FAILED | 文件轉寫HTTP接收失敗。 | 確認網絡連接是否正常。 |
240074 | HTTP_RESPONSE_ERROR | 文件轉寫接收內容解析失敗。 | 內部錯誤，請重試。 |
240075 | HTTP_SERVER_ERROR | 文件轉寫服務錯誤，詳細錯誤請參考服務錯誤碼。 | 請參考服務端錯誤碼進一步確認原因。 |
網絡超時錯誤
錯誤碼 | 錯誤消息 | 描述 | 解決方法 |
240090 | UPDATE_CONTEXT_TIMEOUT | 更新客戶端信息超時 | 內部服務錯誤，需要客戶端進行重試。 |
240091 | CONNECTION_TIMEOUT | 網絡連接超時 | 內部服務錯誤，需要客戶端進行重試。 |
240092 | PARTIAL_ASR_TIMEOUT | 獲取中間識別結果超時 | 內部服務錯誤，需要客戶端進行重試。 |
240093 | ASR_TIMEOUT | 獲取最終識別結果超時 | 內部服務錯誤，需要客戶端進行重試。 |
240094 | DIALOG_TIMEOUT | 獲取對話理解結果超時 | 內部服務錯誤，需要客戶端進行重試。 |
240095 | WWV_TIMEOUT | 獲取云端喚醒確認結果超時 | 內部服務錯誤，需要客戶端進行重試。 |
服務端錯誤碼
當收到EVENT_ASR_ERROR事件，并且錯誤碼為DEFAULT_NLS_ERROR（240062）或HTTP_SERVER_ERROR（240075）時，可以通過錯誤事件header中status字段獲取服務端錯誤碼，并進行進一步問題定位。
錯誤碼 | 原因 | 解決方法 |
40000001 | 身份認證失敗。 | 檢查使用的令牌是否正確、是否過期。 |
40000002 | 無效的消息。 | 檢查發送的消息是否符合要求。 |
403 | 令牌過期或無效的參數 |
|
40000004 | 空閑超時。 | 確認是否長時間（10秒）未發送數據到服務端。 |
40000005 | 請求數量過多。 | 檢查是否超過了并發連接數或者每秒鐘請求數。如果超過并發數，建議從免費版升級到商用版，或者商用版擴容并發資源。 |
40000000 | 默認的客戶端錯誤碼。 | 檢查對應的錯誤消息。 |
40000010 | 試用期已結束，并且未開通商用版、或賬號欠費。 | 請登錄控制臺確認服務開通狀態以及賬戶余額。 |
41010120 | 客戶端超時錯誤。 | 客戶端連續10秒及以上沒有發送數據，導致客戶端超時錯誤。 |
50000000 | 默認的服務端錯誤。 | 內部服務錯誤，需要客戶端進行重試。 |
50000001 | 內部調用錯誤。 | 內部服務錯誤，需要客戶端進行重試。 |
52010001 | 內部調用錯誤。 | 內部服務錯誤，需要客戶端進行重試。 |
40010001 | 不支持的接口。 | 請升級到最新的SDK。 |
40010002 | 不支持的指令。 | 請升級到最新的SDK。 |
40010003 | 無效的指令。 | 請升級到最新的SDK。 |
40010004 | 客戶端提前斷開連接。 | 檢查是否在請求正常完成之前關閉了連接。 |
40010005 | 任務狀態錯誤。 | 發送了當前任務狀態不能處理的指令。 |
40020105 | 應用不存在。 | 解析路由時找不到應用。 |
40020106 | appkey和token不匹配。 | 檢查應用Appkey是否正確，是否與令牌歸屬同一個賬號。 |
40020503 | 子賬戶鑒權失敗。 | 使用父賬戶對調用的子賬戶授權POP API的訪問權限。 |
41040201 | 客戶端10s內停止發送數據。 | 檢查網絡問題，或者檢查業務中是否存在不發數據的情況。 |
41040202 | 客戶端發送數據過快，服務器資源已經耗盡。 | 檢測客戶端發包是否過快，是否按照1:1的實時率發包。 |
41040203 | 客戶端發送音頻格式不正確。 | 請將音頻數據的格式轉換為SDK目前支持的音頻格式。 |
41040204 | 客戶端調用方法異常。 | 客戶端應該先調用發送請求接口，發送請求完畢后再調用其他接口。 |
41040205 | 客戶端設置MAXSILENCE_PARAM方法異常。 | 參數MAXSILENCE_PARAM的范圍為200～2000。 |
41050008 | 采樣率不匹配。 | 檢查調用時設置的采樣率和管控臺上appkey綁定的ASR模型采樣率是否一致。 |
51040101 | 服務端內部錯誤。 | 未知錯誤。 |
51040103 | 實時語音識別服務不可用 | 檢查實時語音識別服務是否有任務堆積等導致任務提交失敗 |
51040104 | 請求實時語音識別服務超時。 | 排查實時語音識別日志。 |
51040105 | 調用實時語音識別服務失敗。 | 檢查實時語音識別服務是否啟動，端口是否正常開啟。 |
51040106 | 實時語音識別服務負載均衡失敗，未獲取到實時語音識別服務的IP地址。 | 檢查VPC中的實時語音識別服務機器是否有異常。 |