Unity 常见错误代码
更新时间:2022-06-22
本文主要介绍在调用环信即时通讯 Unity SDK 中的接口过程中,SDK 返回的错误码和错误信息。
你可以根据如下错误码及错误信息了解出错的可能原因,并采取响应措施。
环信即时通讯 Unity SDK 在运行过程中,可能通过如下方式返回错误码和错误信息:
- 调用方法失败时的返回值。
- 通过
onError
回调报告错误码。
例如,注册时用户返回已存在的错误可以这样检测:
SDKClient.Instance.Login(username, passwd,
handle: new CallBack(
onSuccess: () =>
{
},
onError: (code, desc) =>
{
//注册失败,回调函数会返回错误码和错误描述
//如:code为:USER_ALREADY_EXIST(203)
//desc : User already exist.
}
)
);
错误码定义如下:
错误码 | 错误信息 | 描述和可能原因 |
---|---|---|
0 | EM_NO_ERROR | 提示操作成功。 |
1 | GENERAL_ERROR | 默认未区分类型的错误:提示 SDK 内部未正确初始化,或者请求服务器时未识别出具体原因的错误。 |
2 | NETWORK_ERROR | 网络错误:无网络服务时会回调此错误,表示 SDK 与服务器的连接已断开。 |
4 | EXCEED_SERVICE_LIMIT | 超过服务限制:超过服务版本的数量限制,比如创建的用户 ID 数量超过购买服务的限制时提示该错误。 |
5 | SERVICE_ARREARAGES | 服务欠费,该错误码已废弃。 |
100 | INVALID_APP_KEY | App Key 不合法:你的 App Key 格式不正确。 |
101 | INVALID_USER_NAME | 用户 ID 不正确:一般是用户 ID 为空时提示该错误,比如使用邀请好友 API 时 username 参数为空字符。 |
102 | INVALID_PASSWORD | 用户密码不正确:登录时提供的密码为空或不正确。 |
103 | INVALID_URL | URL 不正确,该错误码已废弃。 |
104 | INVALID_TOKEN | 登录时提供的 token 为空或不正确。 |
105 | USER_NAME_TOO_LONG | 用户名过长:用户名长度限制 64 个字节。 |
108 | TOKEN_EXPIRED | 声网 token 已过期:超出声网 token 有效期时间。 |
109 | TOKEN_WILL_EXPIRE | 声网 token 即将过期:超出声网 token 有效期一半时间时会开始回调此错误码。 |
200 | USER_ALREADY_LOGIN | 用户已经登录:同一个用户 ID 已经登录。 |
201 | USER_NOT_LOGIN | 用户未登录:如果未登录成功时发送消息,或者使用群组操作的 API,SDK 会提示该错误。 |
202 | USER_AUTHENTICATION_FAILED | 用户鉴权失败:一般是 token 鉴权失败或者 token 已经过期。 |
203 | USER_ALREADY_EXIST | 用户已经存在:注册用户 ID 时如果该 ID 已经存在会提示该错误。 |
204 | USER_NOT_FOUND | 用户不存在:比如登录或者获取用户会话列表时用户 ID 不存在。 |
205 | USER_ILLEGAL_ARGUMENT | 用户参数不正确:比如创建用户 ID 时不符合格式要求, 或者更新用户属性时用户参数为空等。 |
206 | USER_LOGIN_ANOTHER_DEVICE | 用户在其他设备登录:如果未开启多设备登录,则在其他设备登录会将当前登录的设备踢下线,用户会收到此错误。 |
207 | USER_REMOVED | 用户已经被注销:如果登录用户被从管理后台删除 ID 则会收到此错误。 |
208 | USER_REG_FAILED | 用户注册失败:注册用户 ID 时失败,比如未开启开放注册功能等原因。 |
209 | PUSH_UPDATECONFIGS_FAILED | 更新推送配置错误:用户更新推送昵称,设置免推送配置时失败。 |
210 | USER_PERMISSION_DENIED | 用户无权限:例如如果用户被封禁,发送消息时会提示该错误。 |
211 | USER_BINDDEVICETOKEN_FAILED | 用户更新推送 token 错误,该错误码已废弃。 |
212 | USER_UNBIND_DEVICETOKEN_FAILED | 用户更新推送 token 错误,该错误码已废弃。 |
213 | USER_BIND_ANOTHER_DEVICE | 用户已经在另外设备登录:如果用户设置为先登录的设备优先,则后登录设备登录失败并提示该错误。 |
214 | USER_LOGIN_TOO_MANY_DEVICES | 用户登录设备数超过限制:用户同一 ID 登录设备数量超过限制提示该错误。 |
215 | USER_MUTED | 用户在群组聊天室中被禁言:用户被禁言后发送消息时提示该错误。 |
216 | USER_KICKED_BY_CHANGE_PASSWORD | 用户密码更新:当前登录的用户密码被修改后,当前登录会断开并提示该错误。 |
217 | USER_KICKED_BY_OTHER_DEVICE | 用户被踢下线:开启多设备后,如果用户在其他设备上通过调用 API 或者管理后台将当前设备登录的 ID 强制退出登录,SDK 会提示该错误。 |
218 | USER_ALREADY_LOGIN_ANOTHER | 其他用户已登录:SDK 未退出登录前又被使用不同的账户登录。 |
219 | USER_MUTED_BY_ADMIN | 用户被禁言:用户在当前 app key 被禁言后发送消息时提示该错误。 |
220 | USER_DEVICE_CHANGED | 用户登录设备与上次不一致:用户登录设备与上次登录设备不一致,需要用户重新登录,注意:默认会允许用户登录,踢掉另一个设备上的登录,此 error 在打开不踢掉另外设备上的登录开关后才会生效。 |
221 | USER_NOT_FRIEND | 非好友禁止发消息:开通非好友禁止发消息后,非好友间发消息提示此错误。该功能可在控制台开通。 |
300 | SERVER_NOT_REACHABLE | 请求服务失败:发送或撤回消息时,如果 SDK 与消息服务器未保持连接,会返回该错误;操作群组、好友等请求时,如果因网络连接太差而不成功,也会返回该错误。 |
301 | SERVER_TIMEOUT | 请求服务超时:如果调用 API 在特定时间内服务器未响应则返回该错误,一般是 30 秒或者 60 秒。 |
302 | SERVER_BUSY | 服务器忙碌:服务器当前忙碌会返回该错误,建议稍后再尝试请求。 |
303 | SERVER_UNKNOWN_ERROR | 服务请求的通用错误码:当请求服务器未成功时的默认错误,该错误发生情况较多,需要根据日志进一步排查。 |
304 | SERVER_GET_DNSLIST_FAILED | 获取服务器配置信息错误:SDK 获取当前应用的服务器配置时失败。 |
305 | SERVER_SERVICE_RESTRICTED | 当前 app 被禁用:如果 app 因为某种原因被禁用时会返回该错误。 |
400 | FILE_NOT_FOUND | 文件未找到:当用户获取不到日志文件,或者下载附件失败时提示该错误。 |
401 | FILE_INVALID | 文件异常:当上传消息附件或者群组共享文件时可能会提示该错误。 |
402 | FILE_UPLOAD_FAILED | 上传文件错误:上传消息附件失败时提示该错误。 |
403 | FILE_DOWNLOAD_FAILED | 下载文件错误:下载消息附件失败时提示该错误。 |
404 | FILE_DELETE_FAILED | 删除文件错误:通过 API 获取日志文件时会将旧的日志文件删除,如果删除失败提示该错误。 |
405 | FILE_TOO_LARGE | 文件太大:消息附件或群共享文件超过文件大小限制时提示该错误。 |
406 | FILE_CONTENT_IMPROPER | 文件内容不合规:消息附件或群共享文件内容不合规时提示该错误。 |
500 | MESSAGE_INVALID | 消息异常错误:如果要发送的消息为空,或者消息 ID 为空,或者消息的发送方 ID 与当前登录 ID 不同则会提示该错误。 |
501 | MESSAGE_INCLUDE_ILLEGAL_CONTENT | 消息含有非法内容:如果消息被过滤系统识别为非法消息时返回该错误。 |
502 | MESSAGE_SEND_TRAFFIC_LIMIT | 消息限流:发送消息过快时提示该错误,建议降低频率或者减少消息内容的大小。 |
503 | MESSAGE_ENCRYPTION_ERROR | 消息加密错误:该错误码已废弃。 |
504 | MESSAGE_RECALL_TIME_LIMIT | 消息撤回超时错误:如果超过消息撤回允许的时间尝试撤回时提示该错误。 |
505 | SERVICE_NOT_ENABLED | 服务未开启:尝试使用某些未开通的功能时提示该错误。 |
506 | MESSAGE_EXPIRED | 消息已过期:发送群组回执时如果已经超过时间限制 (默认 3 天) 会提示该错误。 |
507 | MESSAGE_ILLEGAL_WHITELIST | 用户未在白名单中:如果群组聊天室开启全员禁言,且用户未在白名单中发送消息时提示该错误。 |
508 | MESSAGE_EXTERNAL_LOGIC_BLOCKED | 消息执行发送前回调,被用户自己的逻辑拦截:发送的消息被用户自己的服务器定义的规则拦截掉时提示该错误。 |
600 | GROUP_INVALID_ID | 群组 ID 异常:使用群组相关 API,提供的群组 ID 为空时提示该错误。 |
601 | GROUP_ALREADY_JOINED | 已在该群组中:调用加入群组的 API 时如果已经在该群组中则提示该错误。 |
602 | GROUP_NOT_JOINED | 未加入该群组:尝试在未加入的群组中发送消息或进行群组操作时提示该错误。 |
603 | GROUP_PERMISSION_DENIED | 无权限的群组操作:没有权限进行群组操作,比如群组成员不能设置群组管理员。 |
604 | GROUP_MEMBERS_FULL | 群组已满:群组已经达到人数上限。 |
605 | GROUP_NOT_EXIST | 群组不存在:尝试对不存在的群组进行操作时提示该错误。 |
700 | CHATROOM_INVALID_ID | 聊天室 ID 异常:使用聊天室相关 API,提供的聊天室 ID 为空时提示该错误。 |
701 | CHATROOM_ALREADY_JOINED | 已在该聊天室中:调用加入聊天室的 API 时如果已经在该聊天室中则提示该错误。 |
702 | CHATROOM_NOT_JOINED | 未加入该聊天室:尝试在未加入的聊天室中发送消息或进行聊天室操作时提示该错误。 |
703 | CHATROOM_PERMISSION_DENIED | 无权限的聊天室操作:没有权限进行聊天室操作,比如聊天室成员不能设置聊天室管理员。 |
704 | CHATROOM_MEMBERS_FULL | 聊天室已满:聊天室已经达到人数上限。 |
705 | CHATROOM_NOT_EXIST | 聊天室不存在:尝试对不存在的聊天室进行操作时提示该错误。 |
900 | PUSH_NOT_SUPPORT | 第三方推送不支持:如果用户配置的第三方推送在当前设备上不支持,会提示该错误。 |
901 | PUSH_BIND_FAILED | 绑定第三方推送 token 失败:如果将第三方推送 token 上传到服务器失败时会返回该错误。 |
902 | PUSH_UNBIND_FAILED | 解绑第三方推送 token 失败:如果解绑第三方推送 token 失败会提示该错误。 |