错误码和警告码

更新时间 2023/03/13 03:10:07

在调用声网 API 过程中，SDK 可能会返回错误码和警告码。其中错误码意味着 SDK 遭遇了不可恢复的错误，需要 app 干预；警告码意味着 SDK 遇到问题，但有可能恢复。警告码仅起告知作用，一般情况下 app 可以忽略警告码。

无论是何种情况，你都可以参考本文，了解这些错误码和警告码的详细含义，及其解决方法。对于未给出解决方法的错误码，声网推荐你联系技术支持，我们的技术服务会根据你在实际场景中遇到的问题进行排查。

SDK 在返回错误码时，可能会返回一个负数。这个负数就对应着错误码或警告码里的正整数。例如返回 -2，则对应错误码或警告码里的 2。

Native 及第三方框架

本节适用于如下平台的声网 RTC SDK：

原生平台，如 Android、iOS、macOS、Windows。
第三方框架，即基于原生平台封装的第三方平台，如 Electron、Unity、React Native、Flutter 等。

声网 SDK 在运行过程中，可能通过如下方式返回错误码或警告码：

在方法调用失败的返回值中，返回一个负数，这个负数就对应着错误码与警告码里的正数。
通过 onError 或者 onWarning 回调报告错误码或警告码。

基础错误码

枚举值	说明
`0`	没有错误。
`1`	一般性的错误（没有明确归类的错误原因）。请重新调用方法。
`2`	方法中设置了无效的参数。例如指定的频道名中含有非法字符。请重新设置参数。
`3`	SDK 尚未准备好。可能的原因有： `RtcEngine` 初始化失败。请重新初始化 `RtcEngine`。调用方法时用户尚未加入频道。请检查方法的调用逻辑。调用 `rate` 或 `complain` 方法时用户尚未离开频道。请检查方法的调用逻辑。请检查是否已开启音频模块。请检查程序集完整性。
`4`	`RtcEngine` 当前状态不支持该操作。可能的原因有： Android 平台调用 `setBeautyEffectOptions` 方法时，如果设备版本低于 Android 5.0，会报这个错。请确认 Android 设备版本。使用内置加密时，设置的加密模式不正确，或加载外部加密库失败。请检查加密的枚举值是否正确，或重新加载外部加密库。
`5`	方法调用被拒绝。可能的原因有： `RtcEngine` 初始化失败。请重新初始化 `RtcEngine`。在创建 `RtcChannel` 对象时，将频道名设为空字符 ""。请重新设置频道名。多频道场景下，在调用 `joinChannel` 方法加入频道时，设置的频道名已存在。请重新设置频道名。已经通过 `RtcChannel` 加入了一个频道，并在该 `RtcChannel` 频道中发布了音视频流，又尝试通过 `RtcEngine` 的 `joinChannel` 方法加入第二个频道。如果已经通过 `RtcChannel` 对象加入了一个频道，且在该频道内发了流，就不能再通过 `RtcEngine` 的 `joinChannel` 方法加入第二个频道。在调用 `switchChannel` 方法切换直播频道时，用户角色不是观众。调用 `switchChannel` 方法时，请确保当前的用户角色为观众。
`6`	缓冲区大小不足以存放返回的数据。
`7`	`RtcEngine` 尚未初始化就调用方法。请确认在调用该方法前已创建 `RtcEngine` 对象，并完成初始化。
`9`	没有操作权限。请检查用户是否授予了 app 音视频设备的使用权限。
`10`	方法调用超时。有些方法调用需要 SDK 返回结果，如果 SDK 处理事件过长，超过 10 秒没有返回，会出现此错误。
`17`	加入频道被拒绝。一般有以下原因：用户已经在频道中，再次调用加入频道的方法，如 `joinChannel` 时，会返回此错误。停止调用该方法即可。用户在调用 `startEchoTest` 进行通话测试时，未调用 `stopEchoTest` 结束当前测试，就尝试加入频道。开始通话测试后，需要先调用 `stopEchoTest` 结束当前测试，再加入频道。
`18`	离开频道失败。一般有以下原因：用户已离开频道，再次调用退出频道的方法，如 `leaveChannel` 时，会返回此错误。停止调用该方法即可。用户尚未加入频道，就调用退出频道的方法。这种情况下无需额外操作。
`19`	资源已被占用，不能重复使用。
`20`	SDK 放弃请求，可能由于请求的次数太多。
`21`	Windows 下特定的防火墙设置导致 `RtcEngine` 初始化失败然后崩溃。
`22`	当 app 占用资源过多或系统资源耗尽时，SDK 分配资源失败，会返回该错误。
`101`	不是有效的 App ID。请更换有效的 App ID 重新加入频道。
`102`	不是有效的频道名。可能的原因是设置的参数数据类型不正确。请更换有效的频道名重新加入频道。
`103`	无法获取当前区域的服务器资源。请在初始化 `RtcEngine` 时尝试指定其他区域。
`109`	弃用：从 v2.4.1 起废弃。请改用 `onConnectionStateChanged` 回调中的 `CONNECTION_CHANGED_TOKEN_EXPIRED(9)`。当前使用的 Token 过期，不再有效。请在服务端申请生成新的 Token，并调用 renewToken 更新 Token。
`110`	弃用：从 v2.4.1 起废弃。请改用 `onConnectionStateChanged` 回调中的 `CONNECTION_CHANGED_INVALID_TOKEN(8)`。 Token 无效。一般有以下原因：在声网控制台中启用了 App 证书，但在代码里只使用了 App ID。当项目启用了 App 证书，就必须使用 Token 鉴权。生成 Token 时填入的 uid 字段，和用户加入频道时填入的 uid 不匹配。
`111`	网络连接中断。SDK 在和服务器建立连接后，失去了网络连接超过 4 秒，会报告该错误。
`112`	网络连接丢失。网络连接中断，且 SDK 无法在 10 秒内连接服务器，会报告fail错误。
`113`	调用方法时用户不在频道内。
`114`	在调用 `sendStreamMessage` 时，当发送的数据长度大于 1024 个字节时，会返回该错误。
`115`	在调用 `sendStreamMessage` 时，当发送数据的频率超过限制（6 KB/s）时，会返回该错误。
`116`	在调用 `createDataStream` 时，如果创建的数据通道过多（超过 5 个）时，会返回该错误。
`117`	数据流发送超时。
`119`	弃用：从 v3.7.0 起废弃。请改用 `onConnectionStateChanged` 回调中的 `CLIENT_ROLE_CHANGE_FAILED_REASON`。用户切换角色失败。
`120`	解密失败。可能是用户加入频道时使用了错误的密码。请检查用户加入频道时填入的密码，或引导用户尝试重新加入频道。
`123`	此用户被服务器禁止。当用户被服务端踢出时会报这个错。
`134`	无效的用户 user account，可能是因为设置了无效的参数。

水印相关错误码

枚举值	说明
`124`	水印文件参数错误。
`125`	水印文件路径错误。
`126`	水印图片文件格式错误。SDK 只支持添加 PNG 格式的水印图片。
`127`	水印文件信息错误。
`128`	水印文件数据格式错误。
`129`	水印文件读取错误。

推流相关错误码

枚举值	说明
`130`	如果开启了媒体流加密，则在调用 `addPublishStreamUrl` 时，会返回该错误。SDK 不支持将加密过的流推到 CDN 上。
`151`	旁路推流报错。请调用 `removePublishStreamUrl` 删除当前的推流地址，然后调用 `addPublishStreamUrl` 重新尝试推流。
`152`	单个主播的推流地址数目达到上限 10。请删掉一些不用的推流地址，再增加新的推流地址。
`153`	主播操作不属于自己的流，如更新其他主播的流的参数，或停止其他主播的流。请检查 app 逻辑。
`154`	推流服务器出现错误。请调用 `addPublishStreamUrl` 重新推流。
`155`	服务器无法找到数据流。
`156`	推流地址格式有错误。请检查推流地址格式是否正确。

音频相关错误码

枚举值	说明
`160`	客户端正在录音。如需开始新的录音，请先调用 `stopAudioRecording` 停止当前录音，再调用 `startAudioRecording`。
`1005`	音频设备出现错误（未指明何种错误）。请检查音频设备是否被其他应用占用，或者尝试重新进入频道。
`1006`	使用 Java 资源出错。请确认设备内存是否够用，或重启设备。
`1007`	设置的采样频率出现错误。
`1008`	初始化播放设备出错。请检查播放设备是否被其他应用占用，或者尝试重新进入频道。
`1009`	启动播放设备出错。请检查播放设备是否正常。
`1010`	停止播放设备出错。
`1011`	初始化录音设备出错。请检查录音设备是否正常，或者尝试重新进入频道。
`1012`	启动录音设备出错。请检查录音设备是否正常。
`1013`	停止录音设备出错。
`1015`	播放出错。请检查播放设备是否正常，或者尝试重新进入频道。
`1017`	录音错误。请检查音频采集设备是否正常，或者尝试重新进入频道。
`1018`	录音失败。
`1022`	初始化 Loopback 设备错误。
`1023`	启动 Loopback 设备错误。
`1027`	没有使用麦克风的权限。请提示用户开启使用麦克风的权限再重新加入频道。
`1033`	本地音频采集设备被其他应用占用。请用户依次离开频道、停止在其他应用中进行的音频采集，重新加入频道。
`1101`	使用 Java 资源出现错误。请确认设备内存是否够用，或重启设备。
`1108`	音频采集线程中出现异常。请用户重新加入频道。
`1109`	音频播放线程中出现异常。请用户重新加入频道。
`1111`	开启本地音频采集失败。请用户重新加入频道。
`1112`	开启本地音频播放失败。请用户重新加入频道。
`1115`	录音失败。请确认设备权限或网络连接状况。
`1153`	创建 Audio Recorder 失败。请用户重新加入频道。
`1156`	开启本地音频采集失败。请用户重新加入频道。
`1157`	创建 Audio Player 失败。请用户重新加入频道。
`1160`	开启本地音频播放失败。请用户重新加入频道。
`1201`	当前设备不支持音频输入，可能的原因是 Audio Session 的 category 配置不对或音频输入设备被占用。建议终止后台所有应用的进程，重新加入频道。
`1206`	Audio Session 启动失败。请检查你的音频采集设置。
`1210`	初始化音频设备出错。一般出错是因为音频设备的设置参数错误。
`1213`	重新初始化音频设备出错。一般出错是因为音频设备的设置参数错误。
`1214`	重新启动音频设备出错。一般出错是因为 Audio Session 的 category 设置与音频设备的设置不兼容。
`1301`	音频设备模块初始化失败。请禁用并重新启用音频设备，或者重启机器。
`1303`	音频设备模块终止失败。请禁用并重新启用音频设备，或者重启机器。
`1306`	播放设备初始化失败。请禁用并重新启用音频设备，或者重启机器。
`1307`	无音频播放设备，导致初始化失败。请插入音频设备。
`1309`	启动录音失败。请禁用并重新启用音频设备，或者重启机器。
`1311`	创建录音线程失败，可能的原因是内存或设备性能不足。请重启机器或者更换机器。
`1314`	启动录音失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1319`	创建播放线程失败，可能的原因是内存或设备性能不足。请重启机器或者更换机器。
`1320`	启动播放失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1322`	无可用音频采集设备。请连接可用的录音设备。
`1323`	无可用音频播放设备。请连接可用的播放设备。
`1351`	音频设备模块初始化失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1353`	初始化录音设备失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1354`	初始化麦克风失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1355`	初始化播放设备失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1356`	初始化扬声器失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1357`	启动录音失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1358`	启动播放失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1359`	无录音设备。请检查是否有可用的录音设备或者录音设备是否已经被其他应用占用。
`1360`	无播放设备。请检查是否有可用的播放设备或者播放设备是否已经被其他应用占用。
`1735`	Windows Audio 服务被关闭。你需要开启 Windows Audio 服务或重启设备。

视频相关错误码

枚举值	说明
`1003`	弃用：从 v2.4.1 起废弃。请改用 `onLocalVideoStateChanged` 回调中的 `LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4)`。启动摄像头失败。请检查摄像头是否被其他应用占用，或者尝试重新加入频道。
`1004`	启用视频渲染模块失败。
`1501`	没有摄像头使用权限。请检查是否已经打开摄像头权限。
`1502`	弃用：v2.4.1 起废弃。请改用 `onLocalVideoStateChanged` 回调中的 `LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3)`。摄像头正在使用中。
`1600`	未知错误。
`1601`	视频编码初始化失败。请尝试重新加入频道。
`1602`	视频编码失败。请尝试重新加入频道。
`1603`	视频编码参数设置失败。
`1736`	SDK 不支持你在多显卡的 Windows 设备上设置 `excludeWindowList` 屏蔽窗口。

其他错误码

枚举值	说明
`157`	尚未集成必要的动态库。例如，调用 `enableDeepLearningDenoise` 前，你没有将 AI 降噪动态库集成到项目中。调用 `enableRemoteSuperResolution` 前，你没有将超分辨率动态库集成到项目中。
`1001`	加载媒体引擎失败。
`1002`	启动媒体引擎后开始通话失败。请尝试重新进入频道。

警告码

枚举值	说明
`8`	指定的 View 无效，使用视频功能时需要指定 View，如果 View 尚未指定，则返回该警告。
`16`	初始化视频功能失败。有可能是视频资源被占用导致的。用户无法看到视频画面，但不影响语音通信。
`20`	请求处于待定状态。一般是由于某个模块还没准备好，请求被延迟处理。
`103`	没有可用的频道资源。可能是因为服务器没法分配频道资源。
`104`	查找频道超时。在加入频道时 SDK 先要查找指定的频道，出现该警告一般是因为网络太差，无法连接服务器。
`105`	弃用：从 v2.4.1 起废弃。请改用 `onConnectionStateChanged` 回调中的 `CONNECTION_CHANGED_REJECTED_BY_SERVER(10)`。查找频道请求被服务器拒绝。服务器可能没有办法处理这个请求或请求是非法的。
`106`	加入频道超时。查找到指定频道后，SDK 接着加入该频道，超时一般是因为网络太差，连接不到服务器。
`107`	加入频道请求被服务器拒绝。服务器可能没有办法处理该请求或该请求是非法的。
`111`	切换直播视频超时。
`118`	直播场景下设置用户角色超时。
`121`	加入频道失败。
`122`	尝试连接另一个服务器。
`131`	频道连接不可恢复。
`132`	IP 已改变。
`133`	端口已改变。
`701`	打开伴奏文件出错。
`1014`	运行时播放设备出现警告。
`1016`	运行时录音设备出现警告。
`1019`	采集无声音。请确认麦克风是否被占用，录音权限是否给予，采集设备是否正常工作，或者重启设备。
`1020`	播放频率异常。该异常原因为系统 CPU 占用率高，建议关闭其他可能占用 CPU 的应用。还可以检查 app 是否关闭了音频模块，或尝试重新加入频道。
`1021`	采集频率异常，该异常原因为系统 CPU 占用率高，建议关闭其他可能占用 CPU 的应用。还可以检查 app 是否关闭了音频模块，或尝试重新加入频道。
`1025`	音频的采集或播放被系统来电干扰。如需进行音频采集或播放，请用户挂断电话。
`1029`	在通话过程中，Audio Session 的 category 必须设置成 `AVAudioSessionCategoryPlayAndRecord`，`RtcEngine` 会监控这个属性值。当这个值被修改成其他值的时候会触发这个告警，并强制设置回 `AVAudioSessionCategoryPlayAndRecord`。
`1031`	采集的音量过小。请确认麦克风是否静音，或者麦克风增强是否打开。
`1032`	播放的音量过小。请确认对端用户麦克风是否静音，或者其麦克风增强是否打开。
`1033`	本地音频采集设备被其他应用占用。请用户依次离开频道、停止在其他应用中进行的音频采集，重新加入频道。
`1040`	无音频。禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1051`	录制音频时监测到啸叫。请检查两个客户端的距离是否足够远。
`1052`	系统采集和播放音频线程无法完成调度，通常是由于系统 CPU 占用率高。
`1053`	检测到残余回声，该回声可能由系统线程调度不及时或信号溢出导致。
`1323`	无可用音频播放设备。请插入音频设备。
`1324`	音频采集释放有误。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
`1610`	远端用户的原始视频分辨率超出了可以应用超分辨率的范围。
`1611`	已对一个远端用户的视频使用超分辨率。
`1612`	设备不支持使用超分辨率。

Web

如果你使用的是声网 RTC Web SDK 3.x 及之前版本，请参考错误码或警告码。
如果你使用的是声网 RTC Web SDK 4.x 版本，请参考错误码。

微信小程序

声网 Miniapp SDK for WeChat 在调用 API 或运行时，可能会返回一个错误码对象，也可能会返回一个错误码：

错误码对象：包含错误码和对报错原因的描述，你可以根据 reason 中的描述自行判断发生引起错误的原因，然后进行排查
错误码：该类错误码中没有相应的reason，你可以对照错误码参考本文进行排查

错误码	报错原因	排查方法
`401`	请求异常	根据 reason 描述检查使用是否符合要求；如果报的是 `invalid vendor key`，请开通小程序服务权限，详见微信小程序快速开始。
`429`	请求太频繁	根据 `reason` 描述检查使用是否符合要求。
`430`	在订阅前尝试 mute 远端流在订阅前尝试 unmute 远端流请求异常	根据 `reason` 描述检查使用是否符合要求。
`431`	`setRole` 传入的参数错误加入频道失败登录时的 role 传入出错加入频道时的 uid 传入出错重复加入频道，且 uid 不匹配	根据 `reason` 描述检查使用是否符合要求。
`432`	订阅了一个非主播的 uid	根据 `reason` 描述检查使用是否符合要求。
`433`	观众端无法发布流观众端无法取消发布流	根据 `reason` 描述检查使用是否符合要求。
`434`	在加入频道前尝试退出在加入频道前尝试`setRole` 发布流时的 uid 和加入频道时的 uid 不一致取消发布流时的 uid 和加入频道时的 uid 不一致更新 URL 时的 uid 和加入频道时的 uid 不一致	根据 `reason` 描述检查使用是否符合要求。
`500`	内部错误	退出频道并销毁 client 对象后，重建 `client` 对象，调用 `rejoin` 方法尝试重连。
`501`	服务进程异常失去连接	退出频道并销毁 client 对象后，重建 `client` 对象，调用 `rejoin` 方法尝试重连。
`502`	当前服务器过载	退出频道并销毁 client 对象后，重建 `client` 对象，调用 `rejoin` 方法尝试重连。
`503`	服务进程正常退出	N/A
`901`	未找到服务器	检查是否开启小程序的服务权限；也可能是没有配置域名或 uid 参数格式不正确；你还可以检查网络；检查传入的 App ID、Token 是否有效。
`903`	发送消息超时	鉴权失败（比如没填 Token）；也可能是因为网络连接状况不理想，请检查网络。
`904`	websocket 断开	退出频道并销毁 client 对象后，重建 `client` 对象，调用 `rejoin` 方法尝试重连。
`905`	websocket 连接失败	退出频道并销毁 client 对象后，重建 `client` 对象，调用 `rejoin` 方法尝试重连。

这篇文章对你有帮助吗？

是

否