為方便進行問題定位，本文為您介紹語音辨識業務中詳細的錯誤碼資訊。
簡介
錯誤碼包含兩個部分：
SDK錯誤碼。
該錯誤碼是SDK內部運行過程中可能產生的，SDK通過回調介面返回該錯誤碼。
服務端返回的錯誤碼。
當回調介面返回DEFAULT_NLS_ERROR或者HTTP_SERVER_ERROR事件時表明服務端返回錯誤，通過事件header對象中status欄位擷取服務端錯誤碼。
本錯誤碼資訊表適用於一句話識別和即時語音辨識業務。
識別成功
錯誤碼 | 錯誤訊息 | 描述 |
|---|---|---|
0 | SUCCESS | 成功 |
配置或參數錯誤
錯誤碼 | 錯誤訊息 | 描述 |
|---|---|---|
240999 | DEFAULT_ERROR | 內部預設錯誤 |
240001 | NUI_CONFIG_INVALID | 設定檔錯誤 |
240002 | ILLEGAL_PARAM | 非法參數 |
240003 | ILLEGAL_INIT_PARAM | 初始化參數非法 |
240004 | NECESSARY_PARAM_LACK | 缺少必須參數 |
240005 | NULL_PARAM_ERROR | 參數為空白 |
240006 | NULL_LISTENER_ERROR | 未定義事件回調 |
240007 | NULL_DIALOG_ERROR | 無有效對話執行個體，一般在內部狀態錯誤時發生。 |
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 | 內部對話狀態錯誤 |
240014 | STATE_INVALID | 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 | 發起文本理解失敗 |
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串連失敗 |
240065 | HTTP_CONNECT_FAILED | HTTP串連失敗 |
240066 | DNS_FAILED | DNS解析失敗 |
240067 | CONNECT_FAILED | socket串連失敗 |
240068 | SERVER_NOT_ACCESS | 服務端無法訪問 |
240069 | SOCKET_CLOSED | socket已關閉 |
240070 | AUTH_FAILED | 鑒權失敗 |
240071 | HTTPDNS_FAILED | 使用用戶端傳入的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）時，可以通過錯誤事件header中status欄位擷取服務端錯誤碼進行進一步問題定位。
錯誤碼 | 原因 | 解決方案 |
|---|---|---|
40000001 | 身份認證失敗 | 檢查使用的令牌是否正確、是否到期。 |
40000002 | 無效的訊息 | 檢查發送的訊息是否符合要求。 |
403 | 令牌到期或無效的參數 |
|
40000004 | 空閑逾時 | 確認是否長時間（10秒）未發送資料到服務端。 |
40000005 | 請求數量過多 | 檢查是否超過了並發串連數或者每秒鐘請求數。如果超過並發數，建議從免費版升級到商用版，或者商用版擴容並發資源。 |
40000000 | 預設的用戶端錯誤碼 | 查看錯誤訊息或提交工單。 |
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中的即時語音辨識服務機器是否有異常。 |