错误码

  • 小程序

更新时间

查询实时互动 RTC 的 SDK 错误码含义、常见原因和处理建议。

在调用声网 API 过程中,SDK 可能会返回错误码。当收到错误码时,意味着 SDK 遭遇了不可恢复的错误,需要 App 干预。

本文列出常见错误码的详细含义及其解决方法。对于未给出解决方法的错误码,声网推荐你联系技术支持,我们的技术服务会根据你在实际场景中遇到的问题进行排查。

调用声网 RTC 小程序 API 或运行时,SDK 可能会返回一个错误码对象,也可能会返回一个错误码:

  • 错误码对象:包含错误码和对报错原因的描述,你可以根据 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服务进程正常退出无。
901未找到服务器检查是否开启小程序的服务权限;也可能是没有配置域名或 uid 参数格式不正确;你还可以检查网络;检查传入的 App ID、Token 是否有效。
903发送消息超时鉴权失败,可能是因为未填入 Token;也可能是因为网络连接状况不理想,请检查网络。
904websocket 断开退出频道并销毁 client 对象后,重建 client 对象,调用 rejoin 方法尝试重连。
905websocket 连接失败退出频道并销毁 client 对象后,重建 client 对象,调用 rejoin 方法尝试重连。
表格内容超出当前宽度,可横向滚动查看更多列。