3.8 错误码列表

<div style="max-width: 100%; margin: 20px auto;">
    
    <div style="background-color: #ffffff; border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); overflow: hidden; font-family: 'Comic Sans MS', cursive, sans-serif;">
        
        
        <div style="background-color: #F4F8FA; padding: 1px 10px; border-bottom: 1px solid #dee2e6; display: flex; justify-content: space-between; align-items: center;">
            <div style="color: #0E42D2; font-weight: bold;font-size: 1.3rem;">错误码列表概述</div>
            <div>
            </div>
        </div>
        
        <div style="padding: 25px; line-height: 29px; background-image: linear-gradient(transparent 26px, #dee2e6 27px, #dee2e6 27px, transparent 27px); background-size: 100% 28px; min-height: 100px; color: #333;">
            <div>错误码是系统反馈问题的重要标识，了解不同类型的错误码有助于快速排查问题。以下是各类错误码的详细分类：</div>
            <a href="#通用SDK错误码" style="color: #6f42c1; font-weight: 500;">
            <strong>- 1、通用错误码>>>点击跳转&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;</strong></a>
            <a href="#大模型服务相关错误码" style="color: #6f42c1; font-weight: 500;">
            <strong>- 2、大模型服务相关错误码>>>点击跳转&emsp;&emsp;&emsp;</strong></a>
            <br><a href="#唤醒降噪错误码" style="color: #6f42c1; font-weight: 500;">
            <strong>- 3、唤醒降噪SDK错误码>>>点击跳转&emsp;&emsp;&emsp;</strong></a>
            <a href="#个性化使用错误码" style="color: #6f42c1; font-weight: 500;">
            <strong>- 4、个性化使用错误码>>>点击跳转&emsp;&emsp;&emsp;</strong></a>
			<a href="#声音复刻错误码" style="color: #6f42c1; font-weight: 500;">
            <br><strong>- 5、声音复刻错误码>>>点击跳转&emsp;&emsp;&emsp;</strong></a>
            <div></div>
        </div>
        
        </div>
    </div>
</div>

## 1. 通用错误码
> 若错误码在该表中查询不到，且使用了唤醒、合成等能力，可前往[[msc错误码列表]](https://www.xfyun.cn/document/error-code)查询。

|错误码|含义|处理方式|
|:-------------|:-------------|:-------------|
|0|成功||
|10103|场景配置错误|该错误是由于应用没有配置语义理解就使用了文本请求，造成讯飞后台服务找不到处理业务而报错：解决办法有两种，说明如下：前提是必须先开启语义理解1、API对接：直接修改请求代码中的scene为main_box；SDK对接：直接修改aiui.cfg中scene参数值为main_box；2、直接平台操作：应用配置技能后发布上线即可|
|10105|没有权限|检查是否使用的webapi应用，apikey，ip，checksum等授权参数是否正确|
|10106|参数名称错误|检查aiui.cfg配置文件，检查必传参数、格式及编码。常见原因：(1)配置换行漏了“,”号；(2)中英文逗号格式；(3)读取配置后，客户做了二次封装；(4)sdk没有设置唯一的sn信息|
|10107|参数取值错误|检查配置文件，检查参数值是否超过范围或不符合要求|
|10109|上传帧数超过限制|检查客户端是否音频太长，分帧超过3000帧，对于WebAPI请检查数据长度是否超过限制|
|10110|AIUI云端引擎授权不足|1.在我的应用--》服务统计或设备统计中查看授权次数；2.联系商务开通授权|
|10114|超时|检测网络连接或联系服务商|
|10116|云端无对应的scene场景参数|1.检查账号的scene和aiui.cfg的scene是否匹配|
|10120|结果等待超时|网络异常|
|10145|后处理开启，地址未配置|关闭后处理或配置处理地址|
|10146|后处理请求超时|检查是否开启了后处理|
|10147|请求后处理服务出错|检查后处理服务是否正常|
|10148|语义结果超时|语义结果超时|
|10201|日流控超限|联系商务，开通授权|
|10202|套接字连接异常|提供接口返回值，向服务商反馈|
|10204|网络数据包发送异常|提供接口返回值，向服务商反馈|
|10205|网络数据包接收异常|提供接口返回值，向服务商反馈|
|10301|解析消息体失败|提供接口返回值，向服务商反馈|
|10407|APPID和Key不匹配|1.在aiui平台上查询appid和key；2.在aiui.cfg中配置appid和key，有些默认配置了key，切换appid后要显式配置key|
|10408|AIUI装机量授权不足|和11216错误码处理方式相同，联系讯飞商务授权|
|10700|引擎错误|提供接口返回值，向服务商反馈，并提供错误描述中的内部错误取值：如10103 等|
|11004|服务请求上线错误|提供接口返回值，向服务商反馈|
|11200|功能没有授权|1.联系商务开通授权，常见为合成发音人未授权或授权到期；2.如已授权，请在aiui平台先选择其他发音人，再次选择使用的发音人后点击右上角保存|
|11201|日流控超限|联系商务|
|11202|qps限制|联系商务|
|11203|uid被禁用|联系商务查询禁用原因|
|11210|资源appid和应用appid不匹配|检查资源|
|11214|客户端生成unique_id异常||
|11216|AIUI授权不足|联系讯飞商务增加授权|
|11217|授权已用完|1.联系商务调整；2.重新初始化|
|11218|参数设置错误|检查SN参数设置，是否包含特殊字符|
|16005|MSC内部错误|MSC内部错误|
|20001|无有效的网络连接||
|20002|网络连接超时||
|20003|网络连接发生异常||
|20004|无有效的结果||
|20005|无匹配结果||
|20006|录音失败|1、录音无权限，或其他应用录音占用；2、声卡多通道录音：搜索一下日志中的AlsaRecorder，分析具体原因。假如是"libtinyalsa.so" not found， 那么这个就是缺少so，把设备中的libtinyalsa.so放到工程的jnilibs/armeabi-v7a路径下|
|21001|没有安装服务组件||
|21020|与服务的绑定已消亡|保存/sdcard/AIUI/crash和/data/system/dropbox下的崩溃日志|
|21022|AIUI未处于工作状态|先唤醒AIUI，状态切换详情参考AIUI状态一节的解释|
|22001|本地引擎未初始化||
|22002|vad资源未找到|检查aiui中的vad资源路径是否正确|
|23102|离线语法配置错误|检查编译的离线语法|
|23107|离线识别资源无效|检查配置文件离线资源配置|
|23108|未找到构建的离线语法|未找到构建的离线语法|
|23109|识别语法错误|检查编译的离线语法|
|24000|TTS参数错误|检查配置文件TTS设置|
|24001|TTS参数值错误|检查配置文件TTS设置|
|24005|TTS无效资源|检查配置文件TTS设置|
|24006|TTS无效发音人|检查配置文件TTS设置|
|25107|离线资源文件加载失败|检查当前使用的离线资源文件，例如唤醒能力使用时检查唤醒词资源文件路径|
|25202|离线功能未授权|离线sdk的测试版本只能联网测试，离线会报错。正式签订商务后提供完整离线功能|
|20999|未知错误|未知错误|

## 2. 大模型服务相关错误码

> 链接建立相关

| 错误码   | 含义        | 处理方式       |
| :------- | :------- | :------- |
| 401    | 参数校验失败 | 签名验证失败，可能原因有很多：1. 检查api_key,api_secret 是否正确 2.检查计算签名的参数host，date，request-line是否按照协议要求拼接。 3. 检查signature签名的base64⻓度是否正常，正常44个字节，如果超出此范围，则可能是参与base64计算的签名信息已经过编码了,需要使⽤原始字节进⾏base64编码。 |
| 403    | 时间检验失败 | date参数时间戳格式不对或者时间已经过期，与服务端时间戳偏差超过了300s，请检查传⼊的date参数 |

> 会话交互相关

如遇其他错误信息，请反馈服务商进行排查。

## 3. 唤醒降噪错误码
下面错误码为集成VTN CAE SDK能力使用报错说明。不区分是

| 错误                       | 错误码  | 说明                             |
| -------------------------- | ------  | ---------------------------------|
| OPEN_ENGINE_CFG_FAILED     | 600001  | 访问引擎配置文件失败             |
| OPEN_MIDDLE_CFG_FAILED     | 600002  | 打开vtn.ini配置失败              |
| READ_CAE_ENGINE_CFG_FAILED | 600003  | 读取降噪引擎配置失败             |
| LOAD_CAE_ENGINE_LIB_FAILED | 600004  | 加载降噪引擎库失败               |
| CAE_ENGINE_INIT_FAILED     | 600005  | 初始化降噪引擎库失败             |
| SET_CALLBACK_FAILED        | 600006  | 设置回调函数失败                 |
| WIRTE_AUDIO_FAILED         | 600007  | 写音频数据失败                   |
| READ_MIDDLE_CFG_FAILED     | 600008  | 读vtn.ini失败                    |
| READ_ENGINE_CFG_FAILED     | 600009  | 读取引擎配置失败                 |
| PROC_INPUT_DATA_FAILED     | 600010  | 处理输入的音频数据失败           |
| BEAM_PARAM_ERROR           | 600011  | 波束参数错误                     |
| SET_LOG_LEVE_ERROR         | 600012  | 设置log级别报错                  |
| NEW_CAE_HANDLE_ERROR       | 600013  | 创建cae句柄出错                  |
| SET_CAE_PARAM_ERROR        | 600014  | 设置cae参数发生了错误            |
| GET_CAE_PARAM_ERROR        | 600015  | 获取cae参数发生了错误            |
| GET_BEAM_ANGLE_ERROR       | 600016  | 获取波束和角度值发生了错误       |
| GET_BEAM_POWER_ERROR       | 600017  | 获取波束能量值错误               |
| CAE_IS_DESTROY             | 600018  | cae句柄已销毁                    |
| CAE_WRITE_DATA_FAIL        | 600019  | 往cae里写音频数据失败            |
| CAE_HANDLE_NULL            | 600020  | cae句柄位空值                    |
| CAE_INIT_AUTH_FAIL         | 600021  | 初始化授权操作失败               |
| CAE_AUTH_CHECK_FAIL        | 600022  | 唤醒授权用尽，联系商务增加授权   |
| CAE_RESOURCE_CHECK_FAIL    | 600023  | cae依赖的资源不完整              |
| CAE_PROC_IVW_RESULT_FAILE  | 600024  | 处理唤醒结果失败                 |
| CAE_HTREAD_INIT_FAILE      | 600025  | 初始cae工作线程失败              |
| CAE_GET_ANGLE_FAILE        | 600026  | 获取唤醒角度失败                 |
| CAE_INIT_VAD_FAILE         | 600027  | 初始化vad引擎失败                |
| CAE_GET_VPR_RESULT_FAILE   | 600028  | 获取声纹结果失败                 |
| IVW_RES_PATH_ERROR         | 600100  | 唤醒资源路径错误                 |
| IVW_RES_SIZE_ERROR         | 600101  | 唤醒资源大小错误                 |
| IVW_READ_RES_ERROR         | 600102  | 读唤醒资源发生错误               |
| IVW_RES_CHECK_ERROR        | 600103  | 唤醒资源格式错误                 |
| IVW_INIT_FAILE             | 600104  | 初试化唤醒引擎失败               |
| IVW_PTR_IS_NULL            | 600105  | 唤醒引擎指针为空                 |
| IVW_CREATE_INSTANCE_FAILE  | 600106  | 创建唤醒引擎实例失败             |
| IVW_SET_PARAM_FAILE        | 600107  | 设置唤醒引擎参数失败             |
| IVW_GET_PARAM_FAILE        | 600108  | 获取唤醒引擎参数失败             |
| IVW_ADD_ENG_RES_FAILE      | 600109  | 加载唤醒资源失败                 |
| IVW_UPDATE_RES_FAILE       | 600110  | 更新唤醒资源失败                 |
| IVW_SAVE_RES_FAILE         | 600111  | 保存唤醒资源失败                 |
| IVW_DEL_REA_FAILE          | 600112  | 删除唤醒资源失败                 |
| IVW_SET_RES_PARAM_FAILE    | 600113  | 设置唤醒资源参数失败             |
| IVW_GET_RES_PARAM_FAILE    | 600114  | 获取唤醒资源参数失败             |
| IVW_SET_INST_PARAM_FAILE   | 600115  | 设置唤醒实例参数失败             |
| IVW_GET_INST_PARAM_FAILE   | 600116  | 获取唤醒实例参数失败             |
| IVW_GET_RESULT_FAILE       | 600117  | 获取唤醒结果失败                 |
| IVW_REG_CALLBACK_FAILE     | 600118  | 注册回调函数到唤醒实例失败       |
| IVW_UNGEG_CALLBACK_FAILE   | 600119  | 从唤醒实例反注册回调函数失败     |
| IVW_START_INSTANCE_FAILE   | 600120  | 启动唤醒实例失败                 |
| IVW_STOP_INSTANCE_FAILE    | 600121  | 停止唤醒实例失败                 |
| IVW_WRITE_DATA_FAILE       | 600122  | 写入唤醒音频失败                 |
| IVW_INIT_PARAM_ERROR       | 600123  | 初始化唤醒引擎时参数错误         |
| IVW_MLP_ERROR              | 600124  | 加载MLP资源错误                  |
| IVW_FILTER_ERROR           | 600125  | 加载FILLTER资源错误              |
| IVW_KEYWORD_ERROR          | 600126  | 加载KEYWORD资源错误              |
| IVW_ENGINE_LOAD_RES_FAIL   | 600127  | 加载资源到唤醒引擎失败           |
| IVW_INST_OUT_NOT_JSON      | 600128  | 唤醒结果不是JSON串               |
| IVW_INST_OUT_NO_ISTART     | 600129  | 唤醒结果里没有ISTART字段         |
| IVW_INST_OUT_NO_IDURATION  | 600130  | 唤醒结果里没有IDURATION字段      |
| IVW_INST_OUT_NO_NCM        | 600131  | 唤醒结果里没有NCM字段            |
| IVW_INST_OUT_NO_KEYWORD    | 600132  | 唤醒结果里没有KEYWORD字段        |
| IVW_SET_RESULT_CB_FAILE    | 600133  | 设置唤醒结果解析的回调失败       |
| IVW_DATA_CAE_PROC_FAILE    | 600133  | 回调CAE引擎获取能量值和角度失败  |
| IVW_WRITE_AUDIO_FAILE      | 600133  | 写音频到唤醒引擎失败             |
| IVW_NO_SELECT_FRAME        | 600134  | 没有找到唤醒音频帧               |
| IVW_GEN_AGE_RES_FILE       | 600135  | 检查性别、年龄依赖的资源失败     |
| IVW_GENDER_RES_FAILE       | 600136  | 加载性别资源到引擎失败           |
| IVW_AGE_RES_FAILE          | 600137  | 加载年龄资源到内存失败           |
| IVW_START_INST_FAILE       | 600138  | 启动唤醒实例失败                 |
| IVW_STOP_INST_FAILE        | 600139  | 停止唤醒实例失败                 |
| IVW_VPR_INIT_FAILE         | 600140  | 初始化VPR引擎失败                |
| IVW_VPR_NEW_FAILE          | 600141  | 申请VPR资源内存空间失败          |
| IVW_ADD_VECTOR_RES_FAILE   | 600142  | 加载VPR资源失败                  |
| IVW_VECTOR_RES_EMPTY       | 600143  | VPR资源为空                      |
| IVW_READ_VPR_RES_FAILED    | 600144  | 读取VPR资源失败                  |

## 4. 个性化使用错误码

|错误码| 说明|处理方式       |
|:-------------:|:-------------|:-------------|
|31400| request body不是json| 检查上传的个性化数据结构|
|31401| request body不合法| 检查上传的个性化数据是否包含特殊字符或不满足json格式或与协议格式不符|
|31402| appid对应的namespace不存在| 检查namespce取值是否正确：<br>1、自定义动态实体资源为AIUI平台自行分配；<br>2、官方动态实体（联系人或家居），固定取值为 IFLYTEK|
|31403| 内部错误                     | 反馈服务商排查 |
|31405| request body中无sid          | 根据错误信息描述检查对应参数取值 |
|31406| 解析upload schema json错误   | 根据错误信息描述检查对应参数取值 |
|31407| 校验idname，idvalue出错      | 根据错误信息描述检查对应参数取值 |
|31409| packet schema格式错误        | 检查上传个性化数据格式，是否符合json格式，另外检查动态实体内容格式：单条数据都为json格式，不包含特殊字符，每条句式换行隔开   |
|31410| packet schema /upload schema 为空      | 反馈服务商排查    |
|31411| id_name为空                  | 根据错误信息描述检查对应参数取值 |
|31412| id_value为空                 | 根据错误信息描述检查对应参数取值 |
|31413| res_name为空                 | 根据错误信息描述检查对应参数取值 |
|31415| 部分上传失败                  | 反馈服务商排查             |
|31417| 上传自定义级动态实体时，id_value不能为空  | 根据错误信息描述检查对应参数取值 |
|31419| 上传schema失败                | 反馈服务商排查             |
| 32100  | 缺少appid                  | 检查请求参数appid取值       |
| 32101  | 缺少uid                    | 检查请求餐宿中uid取值       |
| 32102  | 缺少sid                    | 检查请求餐宿中uid取值       |
| 32103  | 缺少数据段                  | 反馈服务商排查             |
| 32104  | 缺少id_name                | 根据错误信息描述检查对应参数取值 |
| 32105  | 缺少id_value               | 根据错误信息描述检查对应参数取值 |
| 32106  | 缺少res_name               | 根据错误信息描述检查对应参数取值 |
| 32107  | 缺少namespace              | 根据错误信息描述检查对应参数取值 |
| 32108  | 缺少namespace              | 根据错误信息描述检查对应参数取值 |
| 32109  | 数据段非法无效              | 反馈服务商排查             |
| 32110  | schema无效                 | 反馈服务商排查             |
| 32111  | schema无效                 | 反馈服务商排查             |
| 32112  | schema同步失败             | 反馈服务商排查             |
| 32113  | 数据段超过限制             | 反馈服务商排查              |
| 32114  | 数据段base64解码失败       | 反馈服务商排查              |
| 32115  | 获取打包scheme失败         | 反馈服务商排查              |
| 32116  | 获取打包结果失败           | 反馈服务商排查              |
| 32117  | 调打包服务失败             | 反馈服务商排查              |
| 32118  | schema上传失败             | 反馈服务商排查              |
| 32119  | schema重复上传             | 取消重复数据上传            |
| 32120  | 获取schema失败             | 反馈服务商排查              |
| 32121  | 保存打包结果失败           | 反馈服务商排查               |
| 32122  | 车载个性化同步失败（定制）  | 反馈服务商排查               |
| 32123  | hbase上传失败              | 反馈服务商排查               |
| 32124  | hbase下载失败              | 反馈服务商排查               |
| 32125  | hbase删除失败              | 反馈服务商排查               |
| 32126  | gts上传失败                | 反馈服务商排查               |
| 32127  | gts下载失败                | 反馈服务商排查               |
| 32128  | gts删除失败                | 反馈服务商排查               |
| 35001  | 授权校验失败               | 反馈服务商排查               |

## 5. 声音复刻和声纹服务错误码
| 错误码 | 说明                   |处理方式       |
|:-------------:|:-------------|:-------------|
| 900400 | 参数非法                               | 按照文档检查请求参数 |
| 900401 | 应用鉴权异常                           | 检查应用授权信息 |
| 900402 | 授权已经用完，或单设备资源数量达到上限   | 联系讯飞商务增加授权 |
| 900403 | 未获取服务授权或使用设备未激活          | 联系讯飞商务获取授权或将请求关联的设备先对接AIUI服务进行激活 |
| 900404 | 资源不存在                             | 资源已经删除，确认资源ID |
| 900500 | 内部服务错误                           | 反馈服务商排查  |
| 900501 | 数据库异常                             | 反馈服务商排查  |
| 900601 | 声音复刻失败                           | 反馈服务商排查  |
| 900602 | 声纹匹配请求失败                        | 反馈给服务商    |