iOS API 常见错误码

更新时间:2021-12-31 该文档已不再维护,请看新版 3.X 文档。

新版文档见:iOS 常见错误代码


SDK 中对应头文件 EMErrorCode.h。请根据类型去判断错误,不要根据数字去判断。

iOS 中错误码的类为EMError。

如:注册时用户返回已存在的错误可以这样检测:error.code

错误码 错误信息描述 可能原因
1 EMErrorGeneral 默认未区分类型的错误SDK 内部未正确初始化或提示请求服务器时未识别出的具体原因。
2 EMErrorNetworkUnavailable 网络错误无网络服务时会回调此错误,表示 SDK 与服务器的连接已断开。
3 EMErrorDatabaseOperationFailed 数据库操作失败打开本地数据库失败。
4 EMErrorExceedServiceLimit 超过服务限制超过服务版本的数量限制,比如创建的用户 ID 数量超过上限。
5 EMErrorServiceArrearages 服务欠费该错误码已废弃。
100 EMErrorInvalidAppkey App Key 不合法用户 App Key 格式不正确。
101 EMErrorInvalidUsername 用户 ID 不正确用户 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 当前用户被管理员禁言当前用户被管理员禁言,请联系管理员解除禁言。
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 发送前回调拦截消息发送前被服务器拦截。
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 个获取用户属性的用户个数超过 100。
901 EMErrorUserInfoDataLengthExceed 设置的用户属性太长设置的用户属性太长。单个用户的所有属性数据不能超过 2 KB,单个 app 所有用户属性数据不能超过 10 GB。