错误码查询

通用错误码

实时语音识别错误码

一句话识别错误码

录音文件识别/录音文件识别闲时版错误码

录音文件识别极速版错误码

语音合成/长文本语音合成错误码

语音合成/CosyVoice声音复刻服务错误码

一句话识别/实时语音识别/录音文件识别极速版

• 配置或参数错误

  状态码	状态消息	原因	解决方案
  240999	DEFAULT_ERROR	内部默认错误。	内部未明确错误。
  240001	NUI_CONFIG_INVALID	配置文件错误。	配置文件错误，请确认传入的资源路径内是否有资源文件。如果是Android平台，请参考代码样例主动使用copyAssets接口。
  240002	ILLEGAL_PARAM	非法参数。	请确认传入的格式是否正确，包括字段类型、值范围限制。 例如enable_voice_detection需要设置成bool类型的true，而不是1或者字符串"true"。
  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	本地引擎初始化失败。	请确认本地引擎的模型是否有效、目录是否可读写。

• 音频错误

  状态码	状态消息	原因	解决方案
  240051	UPDATE_AUDIO_ERROR	推送音频错误，一般为输入音频长度大于所需音频。	确认推送的音频长度是否非法。
  240052	MIC_ERROR	连续2s未获取到音频。	请确认在音频数据回调中是否正确提供所需长度的音频。

• 网络错误

  状态码	状态消息	原因	解决方案
  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等信息，以及确认是否开通足够配额。若在使用语音唤醒功能时遇到此错误，除检查 app_key 与 AccessKey 归属、RAM 权限（AliyunNLSFullAccess）、sdk_code 及 device_id 外，建议加入“魔搭语音唤醒模型交流”钉钉群（群号：21295019391）获取针对性支持。
  240071	HTTPDNS_FAILED	使用客户端传入的IP连接失败。	如果使用直接传入IP进行访问，请确认IP是否可访问。
  240072	HTTP_SEND_FAILED	文件转写HTTP发送失败。	确认网络连接是否正常。
  240073	HTTP_RECEIVE_FAILED	文件转写HTTP接收失败。	确认网络连接是否正常。
  240074	HTTP_RESPONSE_ERROR	文件转写接收内容解析失败	服务端返回内容错误。
  240075	HTTP_SERVER_ERROR	文件转写服务错误。	请参考服务端错误码进一步定位。

语音合成/离线语音合成

• SDK相关

  状态码	状态消息	原因	解决方案
  140000	TTS_CREATE_FAILED	引擎初始化失败。	资源路径错误或资源文件异常，常伴随着错误码（TTS_ASSETPATH_INVALID），可查看日志后再确认。确保传入资源路径有效，资源文件齐全。
  140001	TTS_ENGINE_INVALID	引擎没有初始化。	当前TTS实例未创建，请检查是否已经调用初始化接口。
  140002	TTS_TEXT_ERROR	文本非法，如空等。	可查看SDK日志确认文件非法情况，确保传入的文本是有效的。
  140003	TTS_MALLOC_FAILED	内存申请失败。	当前内存不足，请确保足够运行内存。
  140005	TTS_ASSETPATH_INVALID	资源路径为空。	资源路径错误或资源文件异常，可查看日志后再确认。确保传入资源路径有效，资源文件齐全。
  140006	TTS_HANLDE_INVALID	处理线程不存在。	可释放TTS后重新尝试。
  140007	TTS_CREATE_HANLDE_FAILED	创建处理线程失败。	请查看日志中错误信息进行定位。
  140008	TTS_AUTH_FAILED	鉴权失败，无法继续使用SDK。	请检查传入的akId、akSecret和appkey的正确性。可通过查看日志中错误信息确认问题细节，可能是未开通离线鉴权、已耗尽配额等。
  140011	TTS_OPERATE_INVALID	非法操作。	当前处理线程状态非法，可能是在未初始化情况下调用了pause接口等，请确保调用接口符合当前状态。
  140012	TTS_OPEN_FILE_FAILED	打开文件失败。	打开wav debug文件失败，或打开日志文件失败。详细可查看日志错误信息进行确认。
  140013	TTS_STATE_INVALID	状态机校验失败。	当前方法调用不符合当前状态机，可能是在未初始化情况下调用了pause接口等，请确保调用接口符合当前状态。
  140014	TTS_SYNTHESIZER_INIT_ERROR	合成器初始化失败。	创建合成器失败，主要是因为内存不足。
  140015	TTS_SYNTHESIZER_RELEASE_ERROR	合成器释放失败。	合成器释放失败，需要查看日志详细定位。
  140016	TTS_SYNTHESIZER_FAILED	合成失败。	预播放时状态错误，需查看日志详细定位。
  140017	TTS_WAIT_TIMEOUT	超时退出。	等待某个状态超时，需查看日志详细定位。
  140018	TTS_CLOSED	没有编译TTS部分代码。	表示当前SDK中不包含TTS功能，请更换正确SDK运行。

• 参数配置相关

  状态码	状态消息	原因	解决方案
  140100	TTS_PARAM_INVALID	参数无效。	初始化或设置参数时有无效入参，比如空workspace、空回调、空taskId或空文本等。需要查看日志详细定位。
  140101	TTS_PARAM_VALUE_INVALID	参数值无效。	设置参数时无效入参，需要查看日志详细定位。
  140102	TTS_CFG_OPEN_FAILED	配置文件打开失败。	资源路径错误或资源文件异常，可查看日志再确认。确保传入资源路径有效，资源文件齐全。

• 音频处理

  状态码	状态消息	原因	解决方案
  140200	TTS_AM_CREATE_FAILED	播放器创建失败。	SDK内部音频管理器创建失败。
  140210	TTS_AM_OPEN_FAILED	播放器打开失败。	SDK内部音频管理器打开失败，需要查看日志详细定位。
  140210	TTS_DECODER_INIT_FAILED	音频解码器初始化失败。	音频解码器（可能为MP3解码器）初始化失败，需要查看日志详细定位。
  140211	TTS_DECODER_MALLOC_FAILED	音频解码器申请内存失败。	当前内存不足，请确保足够运行内存。
  140212	TTS_DECODER_INPUT_TOO_MANY	单次输入过多数据，将被丢掉。	查看日志确定单次输入数据上限（2000），具体问题需查看日志详细定位。
  140213	TTS_DECODER_OUTPUT_TOO_MANY	输出过多数据，超过缓存，会丢失。	需查看日志详细定位。
  140220	TTS_AP_INIT_FAILED	音频处理单元打开失败（audioplayer）。	一般会伴随着其他AP ErrorCode返回，需要查看日志详细定位。
  140221	TTS_AP_START_FAILED	ap启动出错。	需查看日志详细定位。
  140222	TTS_AP_MALLOC_FAILED	audioplayer内存申请失败	当前内存不足，请确保足够运行内存。
  140231	TTS_BGM_DECODE_INVALID	解码器初始化失败	确认解码器是否已经初始化，可查看日志进行详细定位。
  140233	TTS_BGM_MALLOC_FAILED	内存申请失败	当前内存不足，请确保足够运行内存。
  140237	TTS_BGM_PARAM_INVALID	背景音乐参数设置错误	确认设置参数是否正确，可查看日志详细定位。重点关注日志bgm value:。

• cache相关

  状态码	状态消息	原因	解决方案
  140300	TTS_CACHE_INIT_FAILED	初始化cache失败。	通常伴随着错误码TTS_CACHE_PATH_INVALID，可能是存储路径无效，可通过日志详细定位。
  140302	TTS_CACHE_CMD_ERROR	下达cache指令不合规范。	可查看返回的错误消息和日志详细定位。
  140308	TTS_CACHE_PATH_INVALID	无法创建缓存路径。	可查看返回的错误消息和日志详细定位。
  140309	TTS_CACHE_LIST_CREATE_FAILED	cache列表创建失败。	可查看返回的错误消息和日志详细定位。
  140311	TTS_CACHE_TOO_MANY	缓存太多。	可查看日志详细定位。
  140312	TTS_CACHE_PARAM_INVALID	参数错误。	可查看返回的错误消息和日志详细定位。
  140313	TTS_CACHE_RECORDING_OPEN_FAILED	打开本地文件错误。	文件权限、路径可能存在问题，需要通过日志详细定位。

• font下发相关

  状态码	状态消息	原因	解决方案
  140351	TTS_FONT_INITLIST_FAILED	初始化fontlist管理器。	当前内存不足，请确保足够运行内存。
  140352	TTS_FONT_INITLIST_INVALID	fontlist管理器未初始化。	当前内存不足，请确保足够运行内存。
  140353	TTS_FONT_CMD_INVALID	命令格式错误。	可查看返回的错误消息和日志详细定位。
  140354	TTS_FONT_RESPONSE_ERROR	服务端返回格式错误。	可查看返回的错误消息和日志详细定位。
  140350	TTS_FONT_RESPONSELIST_ERROR	fontlist请求服务端返回格式错误。	可查看返回的错误消息和日志详细定位。
  140356	TTS_FONT_GET_FONTLIST_FAILED	获取fontlist失败。	可查看返回的错误消息和日志详细定位。
  140358	TTS_FONT_LOCALMSG_ERROR	本地list文件解析失败。	可查看返回的错误消息和日志详细定位。
  140359	TTS_FONT_LOCALFILE_ERROR	本次list文件保存失败。	可查看返回的错误消息和日志详细定位。
  140360	TTS_FONT_CLOUDMSG_ERROR	云端list解析失败。	可查看返回的错误消息和日志详细定位。

• 本地引擎相关

  状态码	状态消息	原因	解决方案
  140900	TTS_LOCAL_CRE_ENGINE_ERROR	本地引擎初始化失败。	本地引擎内部错误，需要查看日志中其他错误信息进行定位。
  140901	TTS_LOCAL_ENGINE_INVALID	本地引擎没有初始化。	请检查是否已经初始化了TTS，可查看返回的错误消息和日志详细定位。
  140902	TTS_LOCAL_ASSET_ERROR	本地资源校验失败。	本地引擎从资源路径进行校验时失败，可查看日志详细定位。
  140903	TTS_LOCAL_CRE_TASK_ERROR	创建本地task失败。	可查看日志详细定位。
  140905	TTS_LOCAL_START_FAILED	本地开始合成失败。	可查看日志详细定位。
  140906	TTS_LOCAL_OPERATION_FAILED	本地操作失败，比如本地task不存在或默认错误。	可查看日志详细定位。
  140907	TTS_LOCAL_SWITCH_FONT_FAILED	切换发音人失败。	可查看日志详细定位。
  140908	TTS_LOCAL_GET_SAMPLERATE_FAILED	获取发音人的采样率失败。	可查看日志详细定位。
  140909	TTS_LOCAL_ADD_FRONT_END_FAILED	添加发音人失败。	可查看日志详细定位。
  140910	TTS_LOCAL_VOICE_PATH_INVALID	本地发音人文件不存在或文件鉴权失败。	可查看日志详细定位。
  140911	TTS_LOCAL_VOICE_MISMATCH	本地发音人文件不匹配。	可查看日志详细定位。

• 云端引擎相关

  状态码	状态消息	原因	解决方案
  141000	TTS_CLOUD_CREATE_FAILED	云端引擎初始化失败。	可查看日志详细定位。
  141004	TTS_CLOUD_START_FAILED	云端请求失败。	一般是因为联网失，或输入的Appkey、Token、URL等存在无效参数。具体可查看日志详细定位。
  141007	TTS_CLOUD_NETWORK_BROKEN	网络比较差。	弱网情况，请更换网络环境运行。
  141008	TTS_CLOUD_SSL_CONNECT_FAILED	SSL链接失败，请检查发送参数是否正确。	SSL链接失败，请检查发送参数是否正确。具体可查看日志详细定位。
  141009	TTS_CLOUD_HTTP_CONNECT_FAILED	HTTP链接失败，请检查发送参数是否正确。	HTTP链接失败，请检查发送参数是否正确。具体可查看日志详细定位。
  141010	TTS_CLOUD_DNS_FAILED	链接失败，DNS失败。	链接失败，DNS失败，请检查域名解析是否正确。具体可查看日志详细定位。
  141011	TTS_CLOUD_URL_INVALID	URL无效。	URL无效，可先ping一下确认URL和port是否有效。具体可查看日志详细定位。
  141012	TTS_CLOUD_PROTOCOL_ERROR	云端协议错误。	云端协议错误。具体可查看日志详细定位。
  141013	TTS_CLOUD_PARAMETERS_ERROR	参数错误。	云端参数错误。具体可查看日志详细定位。
  141014	TTS_CLOUD_UNKNOWN_WS_HEAD_TYPE	WebSocket使用未知头类型。	旧客户端已知问题，建议升级到最新版本。

• 服务端状态码

  状态码	状态消息	原因	解决方案
  144001	TTS_CLOUD_AUTH_FAILED	身份认证失败。	检查使用的令牌是否正确，是否过期。
  144002	TTS_CLOUD_INVALID_MESSAGE	无效的消息。	检查发送的消息是否符合要求。
  144003	TTS_CLOUD_INVALID_TOKEN	令牌过期或无效的参数。	首先检查使用的令牌是否过期，然后检查参数值设置是否合理。
  144004	TTS_CLOUD_WAIT_TIMEOUT	空闲超时。	确认是否长时间（超过10s）没有发送数据到服务端。
  144005	TTS_CLOUD_EXCEED_CONCURRENCY	请求数量过多。	检查是否超过了并发连接数或者每秒钟请求数。如果超过并发数，建议从免费版升级到商用版，或者商用版扩容并发资源。
  144006	TTS_CLOUD_DEFAULT_ERROR	云端返回的未分类错误。	比如使用了无效的模型ID，具体可查看日志详细定位。
  144100	TTS_CLOUD_INVALID_INTERFACE	不支持的接口。	使用了不支持的接口。
  144101	TTS_CLOUD_UNSUPPORTED_ORDER	不支持的指令。	使用了不支持的指令。
  144102	TTS_CLOUD_INVALID_ORDER	无效的指令。	指令格式错误。
  144103	TTS_CLOUD_CLIENT_DISCONNECT	客户端提前断开连接。	检查是否在请求正常完成之前关闭了连接。
  144200	TTS_CLOUD_INVALID_APPKEY	应用不存在。	检查应用AppKey是否正确，是否与Token归属同一个账号。
  144300	TTS_CLOUD_INVALID_PARAM	参数错误。	检查是否传递了正确的参数。
  144301	TTS_CLOUD_UNSENDAUDIO	客户端10s未发送命令。	检查网络问题，或者检查业务中是否存在不发数据的情况。
  144302	TTS_CLOUD_SENDAUDIO_TOO_FAST	客户端发送数据过快，服务器资源已经耗尽。	检测客户端发包是否过快，是否按照1:1的实时率发包。
  144303	TTS_CLOUD_INVALID_AUDIO_FORMAT	客户端发送音频格式不正确。	请将音频数据的格式转换为SDK目前支持的音频格式。
  144304	TTS_CLOUD_INVALID_INVOKE	客户端调用方法异常。	客户端应该先调用发送请求接口，发送请求完毕后再调用其他接口。
  144305	TTS_CLOUD_INVALID_MAX_SILENCE	客户端设置MAXSILENCE_PARAM方法异常。	参数MAXSILENCE_PARAM的范围为200～2000。
  144306	TTS_CLOUD_MISMATCHED_SAMPLERATE	采样率不匹配。	检查调用时设置的采样率和管控台上Appkey绑定的ASR模型采样率是否一致。
  144400	TTS_CLOUD_SERVER_ERROR	TTS服务端错误。	如果偶现可以忽略。
  144401	TTS_CLOUD_INTERNAL_SERVER_ERROR	服务端内部错误。	未知错误。
  144402	TTS_CLOUD_SPEECH_TRANSCRIBER_SERVER_ERROR	实时语音识别服务不可用。	检查实时语音识别服务是否有任务堆积等导致任务提交失败。
  144403	TTS_CLOUD_SPEECH_TRANSCRIBER_REQUEST_TIMEOUT	请求实时语音识别服务超时。	排查实时语音识别日志。
  144404	TTS_CLOUD_INVOKE_SPEECH_TRANSCRIBER_FAILED	调用实时语音识别服务失败。	检查实时语音识别服务是否启动，端口是否正常开启。
  144405	TTS_CLOUD_SPEECH_TRANSCRIBER_BALANCE_FAILED	实时语音识别服务负载均衡失败，未获取到实时语音识别服务的IP地址。	检查VPC中的实时语音识别服务机器是否有异常。
  144406	TTS_CLOUD_SERVER_AGAIN	内部调用错误。	内部服务错误，需要客户端进行重试。

调用文件转写 API 报 ServiceUnavailable 如何排查？

建议先在本地环境使用官方提供的调通代码进行测试，将代码中的 AccessKeyId、AccessKeySecret 和 Appkey 替换为用户自己的凭证，以排除预发环境等外部因素干扰，确认服务本身是否正常。

MRCP 服务报错 Missing message appkey 如何处理？

该报错表示请求中缺少appkey参数，请检查service-asr.json等 MRCP 配置文件中appkey字段是否已正确设置且不为空。

SDK 报错 errcode=170801 unit_quota_not_enough 如何解决？

该错误表示可用设备额度不足。请登录智能语音交互控制台，在对应项目中增加分配配额（例如填写 2），以增加测试设备授权额度。

MRCP 协议 TTS 合成返回 004 错误如何排查？

该错误通常与 DNS 解析不稳定或网络丢包有关，请按以下步骤排查：

1. 检查服务器端 DNS 解析情况，确认是否存在解析超时或解析到异常地址。

2. 持续 ping 服务域名（如nls-gateway.cn-shanghai.aliyuncs.com），观察是否存在高丢包率或延迟抖动。

3. 检查本地网络环境，确保连接稳定，排除因网络波动导致的连接中断。