错误码汇总
HTTP识别错误码说明
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
| 错误码 |
错误信息 |
描述 |
| 4 |
Open api request limit reached |
集群超限额 |
| 6 |
No permission to access data |
对控制台内app进行编辑，添加语音权限 |
| 14 |
IAM Certification failed |
IAM鉴权失败，建议用户参照文档自查生成sign的方式是否正确，或换用控制台中ak sk的方式调用 |
| 17 |
Open api daily request limit reached |
每天流量超限额 |
| 18 |
Open api qps request limit reached |
并发超限额 |
| 19 |
Open api total request limit reached |
请求总量超限额 |
| 100 |
Invalid parameter |
无效参数 |
| 110 |
Access token invalid or no longer valid |
Access Token失效 |
| 111 |
Access token expired |
Access token过期 |
| 错误码 |
用户输入/服务端 |
含义 |
一般解决方法 |
| 3300 |
用户输入错误 |
输入参数不正确 |
请仔细核对文档及参照demo，核对输入参数 |
| 3301 |
用户输入错误 |
音频质量过差 |
请上传清晰的音频 |
| 3302 |
用户输入错误 |
鉴权失败 |
token字段校验失败。请使用正确的API_KEY 和 SECRET_KEY生成。或并发、调用量超出限额。或音频采样率不正确（可尝试更换为16k采样率）。 |
| 3303 |
服务端问题 |
语音服务器后端问题 |
请将api返回结果反馈至论坛或者QQ群 |
| 3304 |
用户请求超限 |
用户的请求并发超限 |
请降低识别并发请求频率 （并发以appId计算，移动端如果共用则累计） |
| 3305 |
用户请求超限 |
用户的日pv（日请求量）超限 |
请“申请提高配额”，如果暂未通过，请降低日请求量 |
| 3307 |
服务端问题 |
语音服务器后端识别出错问题 |
目前请确保16000的采样率音频时长低于30s。如果仍有问题，请将api返回结果反馈至论坛或者QQ群 |
| 3308 |
用户输入错误 |
音频过长 |
音频时长不超过60s，请将音频时长截取为60s以下 |
| 3309 |
用户输入错误 |
音频数据问题 |
服务端无法将音频转为pcm格式，可能是长度问题，音频格式问题等。 请将输入的音频时长截取为60s以下，并核对下音频的编码，是否是16K或8k， 16bits，单声道。 |
| 3310 |
用户输入错误 |
输入的音频文件过大 |
语音文件共有3种输入方式： json 里的speech 参数（base64后）； 直接post 二进制数据，及callback参数里url。 分别对应三种情况：json超过10M；直接post的语音文件超过10M；callback里回调url的音频文件超过10M |
| 3311 |
用户输入错误 |
采样率rate参数不在选项里 |
目前rate参数支持16000、8000，填写4000即会有此错误 |
| 3312 |
用户输入错误 |
音频格式format参数不在选项里 |
目前格式仅仅支持pcm，wav或amr，如填写mp3即会有此错误 |
Android识别错误码说明
错误码分为两类错误，错误领域和错误码，其中错误领域的值可以用于交互，错误码仅用于调试，可能会有修改。
错误码仅提示错误，缩小排查的范围， 不能确认具体出错原因。开发时请对照集成指南文档及demo。
| 错误领域 |
描述 |
错误码 |
错误描述及可能原因 |
| 1 |
网络超时 |
|
出现原因可能为网络已经连接但质量比较差，建议检测网络状态 |
|
|
1000 |
DNS连接超时 |
|
|
1001 |
网络连接超时 |
|
|
1002 |
网络读取超时 |
|
|
1003 |
上行网络连接超时 |
|
|
1004 |
上行网络读取超时 |
|
|
1005 |
下行网络连接超时 |
|
|
1006 |
下行网络读取超时 |
| 2 |
网络连接失败 |
|
出现原因可能是网络权限被禁用，或网络确实未连接，需要开启网络或检测无法联网的原因 |
|
|
2000 |
网络连接失败 |
|
|
2001 |
网络读取失败 |
|
|
2002 |
上行网络连接失败 |
|
|
2003 |
上行网络读取失败 |
|
|
2004 |
下行网络连接失败 |
|
|
2005 |
下行网络读取失败 |
|
|
2006 |
下行数据异常 |
|
|
2100 |
本地网络不可用 |
| 3 |
音频错误 |
|
出现原因可能为：未声明录音权限，或 被安全软件限制，或 录音设备被占用，需要开发者检测权限声明。 |
|
|
3001 |
录音机打开失败 |
|
|
3002 |
录音机参数错误 |
|
|
3003 |
录音机不可用 |
|
|
3006 |
录音机读取失败 |
|
|
3007 |
录音机关闭失败 |
|
|
3008 |
文件打开失败 |
|
|
3009 |
文件读取失败 |
|
|
3010 |
文件关闭失败 |
|
|
3100 |
VAD异常，通常是VAD资源设置不正确 |
|
|
3101 |
长时间未检测到人说话，请重新识别 |
|
|
3102 |
检测到人说话，但语音过短 |
| 4 |
协议错误 |
|
出现原因可能是appid和appkey的鉴权失败 |
|
|
4001 |
协议出错 |
|
|
4002 |
协议出错 |
|
|
4003 |
识别出错 |
|
|
4004 |
鉴权错误 ，一般情况是pid appkey secretkey不正确权限 。见下表”4004"鉴权子错误码 |
| 5 |
客户端调用错误 |
|
一般是开发阶段的调用错误，需要开发者检测调用逻辑或对照文档和demo进行修复。 |
|
|
5001 |
无法加载so库 |
|
|
5002 |
识别参数有误 |
|
|
5003 |
获取token失败 |
|
|
5004 |
客户端DNS解析失败 |
|
|
5005 |
|
| 6 |
超时 |
|
语音过长，请配合语音识别的使用场景，如避开嘈杂的环境等 |
|
|
6001 |
未开启长语音时，当输入语音超过60s时，会报此错误 |
| 7 |
没有识别结果 |
|
信噪比差，请配合语音识别的使用场景，如避开嘈杂的环境等 |
|
|
7001 |
没有匹配的识别结果。当检测到语音结束，或手动结束时，服务端收到的音频数据质量有问题，导致没有识别结果 |
| 8 |
引擎忙 |
|
一般是开发阶段的调用错误，出现原因是上一个会话尚未结束，就让SDK开始下一次识别。SDK目前只支持单任务运行，即便创建多个实例，也只能有一个实例处于工作状态 |
|
|
8001 |
识别引擎繁忙 。当识别正在进行时，再次启动识别，会报busy。 |
| 9 |
缺少权限 |
|
参见demo中的权限设置 |
|
|
9001 |
没有录音权限 通常是没有配置录音权限：android.permission.RECORD_AUDIO |
| 10 |
其它错误 |
|
出现原因如：使用离线识别但未将EASR.so集成到程序中；离线授权的参数填写不正确；参数设置错误等。 |
|
|
10001 |
离线引擎异常 |
|
|
10002 |
没有授权文件 |
|
|
10003 |
授权文件不可用 |
|
|
10004 |
离线参数设置错误 |
|
|
10005 |
引擎没有被初始化 |
|
|
10006 |
模型文件不可用 |
|
|
10007 |
语法文件不可用 |
|
|
10008 |
引擎重置失败 |
|
|
10009 |
引擎初始化失败 |
|
|
10010 |
引擎释放失败 |
|
|
10011 |
引擎不支持 |
|
|
10012 |
离线引擎识别失败 。离线识别引擎只能识别grammar文件中约定好的固定的话术，即使支持的话术，识别率也不如在线。请确保说的话清晰，是grammar中文件定义的，测试成功一次后，可以保存录音，便于测试。 |
"4004"鉴权子错误码
| 4004的子错误值 错误码描述 |
原因 |
|
| 4 |
pv超限 |
配额使用完毕，请购买或者申请 |
| 6 |
没勾权限 |
应用不存或者应用没有语音识别的权限 |
| 13 |
并发超限 |
并发超过限额，请购买或者申请 |
| 101 |
API key错误 |
API Key 填错 |
唤醒错误码
| 错误领域 |
描述 |
错误码 |
错误描述 |
| 10 |
录音设备出错 |
|
|
|
|
1 |
录音设备异常 |
|
|
2 |
无录音权限 |
|
|
3 |
录音设备不可用 |
|
|
4 |
录音中断 |
| 11 |
唤醒相关错误 |
|
|
|
没有授权文件 |
11002 |
|
|
授权文件不可用 |
11003 |
|
|
唤醒异常, 通常是唤醒词异常 |
11004 |
|
|
模型文件不可用 |
11005 |
|
|
引擎初始化失败 |
11006 |
|
|
内存分配失败 |
11007 |
|
|
引擎重置失败 |
11008 |
|
|
引擎释放失败 |
11009 |
|
|
引擎不支持该架构 |
11010 |
|
| 38 |
引擎出错 |
|
|
|
|
1 |
唤醒引擎异常 |
|
|
2 |
无授权文件 |
|
|
3 |
授权文件异常 |
|
|
4 |
唤醒异常 |
|
|
5 |
模型文件异常 |
|
|
6 |
引擎初始化失败 |
|
|
7 |
内存分配失败 |
|
|
8 |
引擎重置失败 |
|
|
9 |
引擎释放失败 |
|
|
10 |
引擎不支持该架构 |
|
|
11 |
无识别数据 |
UNIT错误码
点击查看
ios识别错误码说明
识别过程中服务器返回错误状态:
| 错误码 |
说明 |
| -3001 |
协议参数错误 |
| -3002 |
识别过程出错 |
| -3003 |
没有找到匹配结果 |
| -3004 |
PID设置错误 |
| -3005 |
声音质量不符合要求 |
| -3006 |
语音录入过长，请勿超过60s |
离线引擎错误状态:
| 错误码 |
说明 |
| 2228230 |
dat模型文件不可用，请设置 BDS_ASR_OFFLINE_ENGINE_DAT_FILE_PATH |
| 2228231 |
grammar文件无效 ，请设置 BDS_ASR_OFFLINE_ENGINE_GRAMMER_FILE_PATH |
| 2228236 |
识别失败，无法识别。(语法模式下，可能为语音不在自定义的语法规则之下) |
| 2228226 |
[KWS] no license. 首次使用离线引擎请联网，并配置正确的app_id BDS_ASR_OFFLINE_APP_CODE, 绑定BundleId |
| 2225219 |
server speech quality problem。音频质量过低，无法识别。 |
录音设备错误状态
| 错误码 |
说明 |
| 655361 |
录音设备异常 |
| 655362 |
无录音权限 |
| 655363 |
录音设备不可用 |
| 655364 |
录音中断 |
网络错误状态
| 错误码 |
说明 |
| 1966081 |
网络意外出错 |
| 1966082 |
网络不可用 |
| 2031617 |
网络请求超时 |
| 2225213 |
日志中有字样 err_no is: -3011. Server unknown error. 一般是网络有代理导致。联网请不要走代理。 |
Linux识别错误码说明
注意把日志开启（EVRDebugLogLevelTrace级别）
EVRClientErrorCodeServerSpeechQualityProblem错误会被sdk吞掉，： 音频质量有问题。因为即使后端检测到音频质量问题，识别仍可继续，所以用户回调中看不到，只能在日志中能看到。
语音识别错误会被分类，具体见TVoiceRecognitionClientErrorDomain的定义。
加粗为用户侧发生的常见错误
| DOMAIN |
CODE |
值 |
主要来源 |
描述 |
| EVRClientErrorDomainRecord |
|
10 |
SDK |
未知错误 |
| EVRClientErrorDomainVAD |
|
20 |
SDK |
语音数据处理VAD过程出错 |
|
EVRClientErrorCodeVADException |
1 |
SDK |
前端库VAD异常 |
|
EVRClientErrorCodeNoSpeech |
2 |
用户音频流 |
用户未说话 |
|
EVRClientErrorCodeShort |
3 |
用户音频流 |
用户说话声音太短 |
| EVRClientErrorDomainOnline |
|
30 |
用户/服务端 |
在线识别引擎出错 |
|
EVRClientErrorCodeOnlineExceptioin |
1 |
用户/服务端 |
在线识别引擎异常 |
|
EVRClientErrorCodeOnlineNetworkUnavailable |
2 |
用户音频流 |
网络不可用 |
|
EVRClientErrorCodeOnlineTokenFailed |
3 |
用户 |
获取token失败 ，请检测appId appKey appSecret是否填写正确 |
|
EVRClientErrorCodeOnlineResolveUrlFailed |
4 |
用户 |
解析url失败,请检测网络状态 |
| EVRClientErrorDomainLocalNetwork |
|
31 |
用户 |
连接百度服务端的网络问题，先确认联网是否正常 |
|
EVRClientErrorCodeLocalTimeout |
1 |
用户 |
请检测网络状态，请求百度服务器连接超时 |
| EVRClientErrorDomainHTTP |
|
32 |
用户/服务端 |
HTTP协议错误。或日志中出现http status不等于200而出错，这与通常的http访问一样，先检查网络状况，如果网络状况正常，可反馈 |
| EVRClientErrorDomainServer |
|
33 |
用户/服务端 |
服务器返回错误 。或日志中出现-300X，均是后端返回的错误，除了-3005外可尝试重试。 |
|
EVRClientErrorDomainServer |
-3001 |
服务端 |
后端从SDK读数据失败，可能是sdk检测到后端超时，断开了连接，重试 |
|
EVRClientErrorCodeServerRecognError |
-3002 |
服务端 |
识别过程出错 |
|
EVRClientErrorCodeServerNoFindResult |
-3003 |
服务端 |
协议参数错误 |
|
EVRClientErrorCodeServerAppNameUnknownError |
-3004 |
用户 |
appId appKey appSecret填写错误 或流量超过限制 |
|
EVRClientErrorCodeServerSpeechQualityProblem |
-3005 |
用户 |
声音不符合识别要求，通常是语音质量问题或采样率设的不对 。如果确认那块(报错的句子所处的音频位置段)音频没问题，可再检查采样率和别的识别参数有误问题。 音频质量问题，自查对应位置的音频，通常忽略该问题 |
|
EVRClientErrorCodeServerSpeechTooLong |
-3006 |
用户 |
语音过长，确认是否开启了本地vad，以及vad门限是否过大 |
|
|
-3007 |
SDK/服务端 |
后端检测到sdk传递的数据类型不对，通常不会出现，出现则重试 |
|
EVRClientErrorCodeServerSpeechParamsUnknow |
-3008 |
服务端 |
上行参数未知,(可能是gzip解压失败) 后端检测到sdk传递的json参数不对，通常不会出现，出现则重试 |
|
EVRClientErrorCodeServerSpeechNoUploadLink |
-3011 |
用户网络 |
上行流建立失败，可能跟网络状况或后端有关，重试 |
|
|
-3012 |
用户网络 |
下行流建立失败，可能跟网络状况或后端有关，重试 |
|
|
-3013 |
服务端 |
后端错误 |
|
|
-3014 |
用户 |
用户自己取消，忽略之 |
| EVRClientErrorDomainOffline |
|
34 |
服务端 |
未知错误 |
|
EVRClientErrorCodeRecoderException |
1 |
SDK |
未知错误 |
|
EVRClientErrorCodeRecoderNoPermission |
2 |
SDK |
未知错误 |
|
EVRClientErrorCodeRecoderUnAvailable |
3 |
SDK |
未知错误 |
|
EVRClientErrorCodeInterruption |
4 |
SDK |
未知错误 |
| EVRClientErrorDomainCommon |
|
40 |
|
其它错误 |
|
EVRClientErrorCodeServerSpeechNoUploadLink |
4095 |
SDK |
识别器忙 |
|
EVRClientErrorCodeCommonPropertyListInvalid |
2 |
用户 |
垂类设置有误 |
|
EVRClientErrorCodeCommonEnqueueError |
3 |
用户 |
语音数据enqueue失败 |
![]()
