iOS 常见错误代码

大约 9 分钟

iOS 常见错误代码

本文介绍环信即时通讯 iOS SDK 中接口调用或者回调中的错误码。可以根据具体错误码判断具体错误原因。

iOS 中错误码的类为 EMError

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

iOS 的错误码只有当操作出错的时候才会有返回值,否则返回 nil。

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