====== iOS 常见错误代码 ====== 更新时间：2022-08-02 本文介绍环信即时通讯 iOS SDK 中接口调用或者回调中的错误码。可以根据具体错误码判断具体错误原因。 iOS 中错误码的类为 ''EMError''。 如：注册时用户返回已存在的错误可以这样检测：EMError.code == EMErrorUserAlreadyExist。 iOS 的错误码只有当操作出错的时候才会有返回值，否则返回 nil。 ^
错误码
^ 错误信息 ^描述和可能原因 ^ | 1 | EMErrorGeneral |默认未区分类型的错误：SDK 内部未正确初始化或提示请求服务器时未识别出的具体原因。| | 2 | EMErrorNetworkUnavailable |网络错误：无网络服务时会回调此错误，表示 SDK 与服务器的连接已断开。| | 3 | EMErrorDatabaseOperationFailed |数据库操作失败：打开本地数据库失败。| | 4 | EMErrorExceedServiceLimit |超过服务限制：超过服务版本的数量限制，比如创建的用户 ID 数量超过上限。| | 5 | EMErrorServiceArrearages |服务欠费，该错误码已废弃。| | 100 | EMErrorInvalidAppkey |App Key 不合法：用户的 App Key 格式不正确。| | 101 | EMErrorInvalidUsername |用户 ID 为空或不正确，比如使用邀请好友 API 时 username 参数为空字符。| | 102 | EMErrorInvalidPassword |用户密码不正确：登录时提供的密码为空或不正确。| | 103 | EMErrorInvalidURL |URL 不正确，该错误码已废弃。| | 104 | EMErrorUsernameTooLong | 用户名过长。| | 200 | EMErrorUserAlreadyLoginSame |当前用户已经登录：同一用户 ID 已经登录。| | 201 | EMErrorUserNotLogin |用户未登录：如果未登录成功时调用发送消息，群组操作的 API 会提示该错误。| | 202 | EMErrorUserAuthenticationFailed |用户鉴权失败：一般是 token 鉴权失败或者 token 已经过期。| | 203 | EMErrorUserAlreadyExist |用户已经存在：注册的用户 ID 已存在。| | 204 | EMErrorUserNotFound |用户不存在：比如登录或者获取用户会话列表时用户 ID 不存在。| | 205 | EMErrorUserIllegalArgument |用户参数不正确：比如创建用户 ID 时不符合格式要求，或者更新用户属性时用户参数为空等。| | 206 | EMErrorUserLoginOnAnotherDevice |用户在其他设备登录：未开启多设备登录，用户已登录其他设备，当前设备登录失败。| | 207 | EMErrorUserRemoved |用户已经被注销：如果登录用户 ID 被管理员从管理后台删除则会收到此错误。| | 208 | EMErrorUserRegisterFailed |用户注册失败：注册用户 ID 时失败，比如未开启开放注册功能等原因。| | 209 | EMErrorUpdateApnsConfigsFailed |更新推送配置错误：用户更新推送昵称，设置免推送配置时失败。| | 210 | EMErrorUserPermissionDenied |用户无权限：例如，如果用户被封禁，发送消息时会提示该错误。| | 211 | EMErrorUserBindDeviceTokenFailed |用户更新推送 token 错误，该错误码已废弃。| | 212 | EMErrorUserUnbindDeviceTokenFailed |用户更新推送 token 错误，该错误码已废弃。| | 213 | EMErrorUserBindAnotherDevice |用户已经在另外设备登录：如果用户设置为先登录的设备优先，则后登录设备登录失败并提示该错误。| | 214 | EMErrorUserLoginTooManyDevices |用户登录设备数超过限制：用户同一 ID 登录设备数量超过限制提示该错误。| | 215 | EMErrorUserMuted |用户在群组聊天室中被禁言：用户被禁言后发送消息时提示该错误。| | 216 | EMErrorUserKickedByChangePassword |用户密码更新：当前登录的用户密码被修改后，当前登录会断开并提示该错误。| | 217 | EMErrorUserKickedByOtherDevice |用户被踢下线：未开启多设备登录，如果用户在其他设备上登录；或者开启多设备登录后，用户登录设备数量超过限制，则最新一台设备登录时会踢掉第一台设备，SDK 会提示该错误。| | 218 | EMErrorUserAlreadyLoginAnother |其他用户已登录：其他用户已在当前环境下登录 SDK，当前用户不能再登录。| | 219 | EMErrorUserMutedByAdmin |当前用户被管理员禁言，请联系管理员解除禁言。| | 221 | USER_NOT_FRIEND | 非好友禁止发消息：开通非好友禁止发消息后，非好友间发消息提示此错误。该功能可在控制台开通。 | | 300 | EMErrorServerNotReachable |请求服务失败：发送或撤回消息时，如果 SDK 与消息服务器未保持连接，会返回该错误；操作群组、好友等请求时，如果因网络连接太差而不成功，也会返回该错误。| | 301 | EMErrorServerTimeout |请求服务超时：调用 API 时服务器未在特定时间内响应。| | 302 | EMErrorServerBusy |服务器忙碌：服务器当前忙碌，建议稍后重试。| | 303 | EMErrorServerUnknownError |服务请求的通用错误码：当请求服务器未成功时的默认错误，该错误发生情况较多，需要根据日志进一步排查。| | 304 | EMErrorServerGetDNSConfigFailed |获取服务器配置信息错误：SDK 获取当前应用的服务器配置时失败。| | 305 | EMErrorServerServingForbidden |当前 app 被禁用：app 因为某种原因被禁用。| | 400 | EMErrorFileNotFound |文件未找到：当用户获取不到日志文件或者下载附件失败时提示该错误。| | 401 | EMErrorFileInvalid |文件异常：当上传消息附件或者群组共享文件时可能会提示该错误。| | 402 | EMErrorFileUploadFailed |上传文件错误：上传消息附件失败。| | 403 | EMErrorFileDownloadFailed |下载文件错误：下载消息附件失败。| | 404 | EMErrorFileDeleteFailed |删除文件错误：通过 API 获取日志文件时会将旧的日志文件删除，如果删除失败提示该错误。| | 405 | EMErrorFileTooLarge |文件太大：消息附件或群共享文件超过文件大小限制。| | 406 | EMErrorFileContentImproper |文件内容不合规：发送消息上传附件失败时可能提示该错误。| | 500 | EMErrorMessageInvalid |消息异常错误：如果构造的消息为空，或者消息 ID 为空，或者消息的发送方 ID 与当前登录 ID 不同则会提示该错误。| | 501 | EMErrorMessageIncludeIllegalContent |消息含有非法内容：消息被过滤系统识别为非法消息。| | 502 | EMErrorMessageTrafficLimit |消息限流：消息发送速度过快，建议降低频率或者减少消息内容。| | 503 | EMErrorMessageEncryption |消息加密错误：该错误码已废弃。| | 504 | EMErrorMessageRecallTimeLimit |消息撤回超时错误：如果超过消息撤回允许的时间尝试撤回时提示该错误。| | 505 | EMErrorServiceNotEnable |服务未开通：要使用的某些功能未开通。| | 506 | EMErrorMessageExpired |消息已过期：发送群组回执时超过了时间限制 (默认 3 天) 。| | 507 | EMErrorMessageIllegalWhiteList |用户未在白名单中：群组聊天室开启全员禁言时，若用户未在白名单中发送消息时提示该错误。| | 508 | EMErrorMessageExternalLogicBlocked |发送前回调拦截：消息发送前被服务器拦截。| | 509 | EMErrorMessageCurrentLimiting | 单个用户 ID 发送群聊消息超出频率限制。| | 600 | EMErrorGroupInvalidId |群组 ID 异常：群组相关 API 传入的群组 ID 为空。| | 601 | EMErrorGroupAlreadyJoined |已在该群组中：调用加入群组的 API 加入的用户已经在该群组中。| | 602 | EMErrorGroupNotJoined |未加入该群组：在未加入的群组中发送消息或进行群组操作时提示该错误。| | 603 | EMErrorGroupPermissionDenied |无权限的群组操作：没有权限进行群组操作，比如群组成员不能设置群组管理员。| | 604 | EMErrorGroupMembersFull |群组已满：群组已经达到人数上限。| | 605 | EMErrorGroupNotExist |群组不存在：对不存在的群组进行操作。| | 606 | EMErrorGroupSharedFileInvalidId |共享文件 ID 为空：共享文件 ID 为空。| | 700 | EMErrorChatroomInvalidId |聊天室 ID 异常：聊天室相关 API 传入的聊天室 ID 为空。| | 701 | EMErrorChatroomAlreadyJoined |已在该聊天室中：调用加入聊天室的 API 添加的用户已经在该聊天室中。| | 702 | EMErrorChatroomNotJoined |未加入该聊天室：用户在未加入的聊天室中发送消息或进行聊天室操作时提示该错误。| | 703 | EMErrorChatroomPermissionDenied |无权限的聊天室操作：没有权限进行聊天室操作，比如聊天室成员不能设置聊天室管理员。| | 704 | EMErrorChatroomMembersFull |聊天室已满：聊天室已经达到人数上限。| | 705 | EMErrorChatroomNotExist |聊天室不存在：要操作的聊天室不存在。| | 900 | EMErrorUserCountExceed |获取用户属性的用户个数超过 100。 | | 901 | EMErrorUserInfoDataLengthExceed |设置的用户属性太长。单个用户的所有属性数据不能超过 2 KB，单个 app 所有用户属性数据不能超过 10 GB。| | 903 | EMErrorTranslateParamInvalid | 调用翻译方法传入的参数无效，请检查传参。 | | 904 | EMErrorTranslateFail | 翻译服务接口返回错误。 | | 905 | EMErrorTranslateNotInit | 翻译服务未初始化。 | | 1000 | EMErrorContactAddFailed | 添加联系人失败。 | | 1001 | EMErrorContactReachLimit | 邀请者联系人数量已经达到上限。 | | 1002 | EMErrorContactReachLimitPeer | 受邀请者联系人达到上限。 | | 1100 | EMErrorPresenceParamExceed | 调用 Presence 相关方法时参数长度超出限制。 | | 1101 | EMErrorPresenceCannotSubscribeSelf | 不能订阅你自己的状态。| | 1110 | EMErrorTranslateParamError | 翻译参数错误。 | | 1111 | EMErrorTranslateServiceNotEnabled | 翻译服务未启用。 | | 1112 | EMErrorTranslateUsageLimit | 翻译用量达到上限。 | | 1113 | EMErrorTranslateServiceFail | 获取翻译服务失败。 | | 1300 | EMErrorReactionReachLimit | Reaction 数量已达到限制。 | | 1301 | EMErrorReactionHasBeenOperated | Reaction 重复添加。 | | 1302 | EMErrorReactionOperationIsIllegal | 没有操作权限：用户对该 Reaction 没有操作权限。例如没有添加过该 Reaction 的用户进行删除操作，或者单聊消息非发送者和非接受者进行添加 Reaction 操作。 | | 1400 | EMErrorThreadNotExist | 未找到该子区，该子区不存在。 | | 1401 | EMErrorThreadAlreadyExist | 该消息 ID 下子区已存在，重复添加子区。 | | 1402 | EMErrorThreadCreateMessageIllegal | 创建子区的消息无效：创建子区时父消息被撤回了，或者无法使用。 |