错误码

最近更新时间:2019-10-21 11:39:11

(一)IM SDK 的错误码

说明:

Web SDK 相关的错误码请参见 错误码对照表

通用错误码

错误码 描述
0 无错误。
6015 执行中,请做好接口调用控制,例如,第一次初始化操作在回调前,后续的初始化操作会返回该错误码。
6017 参数无效,请检查参数是否符合要求,具体可查看错误信息进一步定义哪个字段。
6022 操作本地 IO 错误,检查是否有读写权限,磁盘是否已满。
6027 错误的 JSON 格式,请检查参数是否符合接口的要求,具体可查看错误信息进一步定义哪个字段。
6028 内存不足,可能存在内存泄漏,iOS 平台使用 Instrument 工具,Android 平台使用 Profiler 工具,分析出什么地方的内存占用高。
6001 PB 解析失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
6002 PB 序列化失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
6013 IM SDK 未初始化,初始化成功回调之后重试。
6005 加载本地数据库操作失败,可能存储文件有损坏,可 提交工单 联系客服定位具体问题。
6019 本地数据库操作失败,可能是部分目录无权限或者数据库文件已损坏。
7001 跨线程错误,不能在跨越不同线程中执行,内部错误,可 提交工单 提供使用接口、错误码、错误信息给客服解决。
7002 TinyId 为空,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7003 Identifier 非法,必须不为空,要求可打印 ASCII 字符(0x20-0x7e),长度不超过32字节。
7004 文件不存在,请检查文件路径是否正确。
7005 文件大小超出了限制,如果上传文件,最大限制是28MB。
7006 空文件,要求文件大小不是0字节,如果上传图片、语音、视频或文件,请检查文件是否正确生成。
7007 文件打开失败,请检查文件是否存在,或者已被独占打开,引起 SDK 打开失败。

帐号错误码

错误码 描述
6014 IM SDK 未登录,请先登录,成功回调之后重试,或者已被踢下线,可使用 TIMManager getLoginUser 检查当前是否在线。
6026 自动登录时,并没有登录过该用户,这时候请调用 login 接口重新登录。
6206 UserSig 过期,请重新获取有效的 UserSig 后再重新登录。
6208 其他终端登录同一个帐号,引起已登录的帐号被踢,需重新登录。
7501 登录正在执行中,例如,第一次 login 或 autoLogin 操作在回调前,后续的 login 或 autoLogin 操作会返回该错误码。
7502 登出正在执行中,例如,第一次 logout 操作在回调前,后续的 logout 操作会返回该错误码。
7503 TLS SDK 初始化失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7504 TLS SDK 未初始化,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7505 TLS SDK TRANS 包格式错误,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7506 TLS SDK 解密失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7507 TLS SDK 请求失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
7508 TLS SDK 请求超时,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。

消息错误码

错误码 描述
6004 会话无效,getConversation 时检查是否已经登录,如未登录获取会话,会有此错误码返回。
6006 文件传输鉴权失败,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
6007 文件传输获取 Server 列表失败,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
6008 文件传输上传失败,请检查网络是否连接,如果上传的是图片,确认图片能够正常打开。
6009 文件传输下载失败,请检查网络,或者文件、语音是否已经过期,目前资源文件存储7天。
6010 HTTP 请求失败,请检查 URL 地址是否合法,可在网页浏览器尝试访问该 URL 地址。
6016 IM SDK 无效消息 elem,具体可查看错误信息进一步定义哪个字段。
6021 无效的对象,例如用户自己生成 TIMImage 对象,或内部赋值错误导致对象无效。
8001 消息长度超出限制,消息长度不要超过8k,消息长度是各个 elem 长度的总和,elem 长度是所有 elem 字段的长度总和。
8002 消息 KEY 错误,内部错误,网络请求包的 KEY 和 回复包的不一致。

群组错误码

错误码 描述
8501 群组 ID 非法,自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节,且前缀不能为 @TGS#(避免与服务端默认分配的群组 ID 混淆)。
8502 群名称非法,群名称最长30字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
8503 群简介非法,群简介最长240字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
8504 群公告非法,群公告最长300字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
8505 群头像 URL 非法,群头像 URL 最长100字节,可在网页浏览器尝试访问该 URL 地址。
8506 群名片非法,群名片最长50字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
8507 超过群组成员数的限制,在创建群和邀请成员时,指定的成员数超出限制,最大群成员数量:私有群是200人,公开群是2000人,聊天室是6000人,音视频聊天室和在线成员广播大群无限制。
8508 不允许申请加入 Private 群组,任意群成员可邀请入群,且无需被邀请人同意。
8509 不允许邀请角色为群主的成员,请检查角色字段是否填写正确。
8510 不允许邀请0个成员,请检查成员字段是否填写正确。

关系链错误码

错误码 描述
9001 资料字段非法,资料支持标配字段及自定义字段,其中自定义字段的关键字,必须是英文字母,且长度不得超过8字节,自定义字段的值最长不能超过500字节。
9002 备注字段非法,最大96字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
9003 请求添加好友的请求说明字段非法,最大120字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
9004 请求添加好友的添加来源字段非法,来源需要添加“AddSource_Type_”前缀。
9005 好友分组字段非法,必须不为空,每个分组的名称最长30字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。

网络错误码

错误码 描述
9501 SSO 加密失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
9502 SSO 解密失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
9503 SSO 未完成鉴权,可能登录未完成,请在登录完成后再操作。
9504 数据包压缩失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
9505 数据包解压失败,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
9506 调用频率限制,最大每秒发起5次请求。
9507 请求队列満,超过同时请求的数量限制,最大同时发起1000个请求。
9508 网络已断开,未建立连接,或者建立 socket 连接时,检测到无网络。
9509 网络连接已建立,重复创建连接,内部错误。
9510 建立网络连接超时,请等网络恢复后重试。
9511 网络连接已被拒绝,请求过于频繁,服务端拒绝服务。
9512 没有到达网络的可用路由,请等网络恢复后重试。
9513 系统中没有足够的缓冲区空间资源可用来完成调用,系统过于繁忙,内部错误。
9514 对端重置了连接,可能服务端过载,SDK 内部会自动重连,请等网络连接成功 onConnSucc ( iOS ) 或 onConnected ( Android ) 回调后重试。
9515 socket 套接字无效,内部错误,可 提交工单 提供使用接口、错误码以及错误信息给客服解决。
9516 IP 地址解析失败,内部错误,可能是本地 imsdk_config 配置文件被损坏,读取到到 IP 地址非法。
9517 网络连接到中间节点或服务端重置,引起连接失效,内部错误,SDK 内部会自动重连,请等网络连接成功 onConnSucc ( iOS ) 或 onConnected ( Android ) 回调后重试。
9518 请求包等待进入待发送队列超时,发送时网络连接建立比较慢 或 频繁断网重连时,会出现该错误,请检查网络连接是否正常。
9519 请求包已进入待发送队列,等待进入系统的网络 buffer 超时,数据包较多 或 发送线程处理不过来,内部错误。
9520 请求包已进入系统的网络 buffer ,等待服务端回包超时,可能请求包没离开终端设备、中间路由丢弃、服务端意外丢包或回包被系统网络层丢弃,内部错误。

(二)服务端的错误码

SSO 接入层的错误码

错误码 描述
-302 SSO 的连接数量超出限制,服务端拒绝服务。
-10000 下发验证码标志错误。
-10001 D2 过期。
-10003 A2 校验失败等场景使用。
-10004 处理下行包时发现 A2 验证没通过或者被安全打击。
-10005 不允许空 D2Key 加密。
-10006 D2 中的 uin 和 SSO 包头的 uin 不匹配。
-10007 验证码下发超时。
-10008 需要带上 IMEI 和 A2 。
-10009 Cookie 非法。
-10101 下发提示语,D2 过期。
-10102 断链锁屏。
-10103 失效身份。
-10104 终端自动退出。
-10105 MSFSDK 自动退出。
-10106 SSO D2key 解密失败次数太多,通知终端需要重置,重新刷新 D2 。
-10107 不支持聚合,给终端返回统一的错误码。终端在该 TCP 长连接上停止聚合。
-10108 预付费欠费。
-10109 请求包格式错误。
-10110 SDKAppID 黑名单。
-10111 SDKAppID 设置 service cmd 黑名单。
-10112 SDKAppID 停用。
-10113 频率限制(用户),频率限制是设置针对某一个协议的每秒请求数的限制。
-10114 过载丢包(系统),连接的服务端处理过多请求,处理不过来,拒绝服务。

资源文件错误码

错误码 描述
114000 要发送的资源文件不存在。
114001 要发送的资源文件不允许访问。
114002 文件大小超过限制。
114003 用户取消发送,如发送过程中登出等原因。
114004 读取文件内容失败。
114005 资源文件(如图片、文件、语音、视频)传输超时,一般是网络问题导致。
114011 参数非法。
115066 文件 MD5 校验失败。
115068 分片 MD5 校验失败。

后台公共错误码

错误码 描述
60002 HTTP 解析错误 ,请检查 HTTP 请求 URL 格式。
60003 HTTP 请求 JSON 解析错误,请检查 JSON 格式。
60004 请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。
60005 请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。
60006 SDKAppID 失效,请核对 SDKAppID 有效性。
60007 REST 接口调用频率超过限制,请降低请求频率。
60008 服务请求超时或 HTTP 请求格式错误,请检查并重试。
60009 请求资源错误,请检查请求 URL。
60010 REST API 请求的 Identifier 字段请填写 App 管理员帐号。
60011 SDKAppID 请求频率超限,请降低请求频率。
60012 REST 接口需要带 SDKAppID,请检查请求 URL 中的 SDKAppID。
60013 HTTP 响应包 JSON 解析错误。
60014 置换帐号超时。
60015 请求包体 Identifier 类型错误,请确认 Identifier 为字符串格式。
60016 SDKAppID 被禁用,请 提交工单 联系客服确认。
60017 请求被禁用,请 提交工单 联系客服确认。
60018 请求过于频繁,请稍后重试。
60019 请求过于频繁,请稍后重试。
60020 您的专业版套餐包已到期并停用,请登录 即时通信 IM 购买页面 重新购买套餐包。购买后,将在5分钟后生效。
80001 文本安全打击,文本中可能包含敏感词汇。
80002 发消息包体过长,目前支持最大8k消息包体长度,请减少包体大小重试。

帐号错误码

错误码 描述
70001 UserSig 已过期,请重新生成 UserSig,建议 UserSig 有效期不小于24小时。
70002 UserSig 长度为0,请检查传入的 UserSig 是否正确。
70003 UserSig 校验失败,请确认下 UserSig 内容是否被截断,如缓冲区长度不够导致的内容截断。
70005 UserSig 校验失败,可用工具自行验证生成的 UserSig 是否正确。
70009 用公钥验证 UserSig 失败,请确认生成的 UserSig 使用的私钥和 SDKAppID 是否对应。
70013 请求的 Identifier 与生成 UserSig 的 Identifier 不匹配。
70014 请求的 SDKAppID 与生成 UserSig 的 SDKAppID 不匹配。
70016 验证 UserSig 时公钥不存在。请先登录控制台下载私钥,下载私钥的具体方法可参考 下载签名用的私钥
70020 SDKAppID 未找到,请在即时通信 IM 控制台确认应用信息。
70052 UserSig 已经失效,请重新生成,再次尝试。
70107 请求的用户帐号不存在。
70114 安全原因被限制。
70169 服务端内部超时,请重试。
70202 服务端内部超时,请重试。
70206 请求中批量数量不合法。
70402 参数非法,请检查必填字段是否填充,或者字段的填充是否满足协议要求。
70403 请求需要 App 管理员权限。
70050 因失败且重试次数过多导致被限制,请检查 UserSig 是否正确,1分钟之后再试。
70051 帐号被拉入黑名单。
70398 创建帐号数量超过免费体验版数量限制,请升级为专业版。
70500 服务端内部错误,请重试。
71000 仅支持删除体验版帐号,您当前为专业版,暂不支持删除。

资料错误码

错误码 描述
40001 请求参数错误,请根据错误描述检查请求是否正确。
40002 请求参数错误,没有指定需要拉取资料的用户帐号。
40003 请求的用户帐号不存在。
40004 请求需要 App 管理员权限。
40005 资料字段中包含敏感词。
40006 服务端内部错误,请稍后重试。
40007 没有资料字段的读权限,详情可参见 资料字段
40008 没有资料字段的写权限,详情可参见 资料字段
40009 资料字段的 Tag 不存在。
40601 资料字段的 Value 长度超过500字节。
40605 标配资料字段的 Value 错误,详情可参见 标配资料字段
40610 资料字段的 Value 类型不匹配,详情可参见 标配资料字段

关系链错误码

错误码 描述
30001 请求参数错误,请根据错误描述检查请求是否正确。
30002 SDKAppID 不匹配。
30003 请求的用户帐号不存在。
30004 请求需要 App 管理员权限。
30005 关系链字段中包含敏感词。
30006 服务端内部错误,请重试。
30007 网络超时,请稍后重试。
30008 并发写导致写冲突,建议使用批量方式。
30009 后台禁止该用户发起加好友请求。
30010 自己的好友数已达系统上限。
30011 分组已达系统上限。
30012 未决数已达系统上限。
30013 黑名单数已达系统上限。
30014 对方的好友数已达系统上限。
30515 请求添加好友时,对方在自己的黑名单中,不允许加好友。
30516 请求添加好友时,对方的加好友验证方式是不允许任何人添加自己为好友。
30525 请求添加好友时,自己在对方的黑名单中,不允许加好友。
30539 A 请求加 B 为好友,B 的加好友验证方式被设置为“AllowType_Type_NeedConfirm”,这时 A 与 B 之间只能形成未决关系,该返回码用于标识加未决成功,以便与加好友成功的返回码区分开,调用方可以捕捉该错误给用户一个合理的提示。
30540 添加好友请求被安全策略打击,请勿频繁发起添加好友请求。
30614 请求的未决不存在。
31704 与请求删除的帐号之间不存在好友关系。
31707 删除好友请求被安全策略打击,请勿频繁发起删除好友请求。
31804 请求的用户帐号不存在。

最近联系人错误码

错误码 描述
50001 请求的用户帐号不存在。
50002 请求参数错误,请根据错误描述检查请求是否正确。
50003 请求需要 App 管理员权限。
50004 服务端内部错误,请重试。
50005 网络超时,请稍后重试。

消息错误码

错误码 描述
20001 请求包非法。
20002 UserSig 或 A2 失效。
20003 Identifier 无效或者 Identifier 未导入即时通信 IM。
20004 网络异常,请重试。
20005 服务端内部错误,请重试。
20006 触发发送单聊消息之前回调,App 后台返回禁止下发该消息。
20007 发送单聊消息,被对方拉黑,禁止发送。
20009 消息发送双方互相不是好友,禁止发送(配置单聊消息校验好友关系才会出现)。
20010 发送单聊消息,自己不是对方的好友(单向关系),禁止发送。
20011 发送单聊消息,对方不是自己的好友(单向关系),禁止发送。
20012 发送方被禁言,该条消息被禁止发送。
20016 消息撤回超过了时间限制(默认2分钟)。
20018 删除漫游内部错误。
90001 JSON 格式解析失败,请检查请求包是否符合 JSON 规范。
90002 JSON 格式请求包中 MsgBody 不符合消息格式描述,或者 MsgBody 不是 Array 类型,请参考 TIMMsgElement 对象 的定义。
90003 JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 字段不是 String 类型。
90005 JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型。
90006 JSON 格式请求包体中缺少 MsgTimeStamp 字段或者 MsgTimeStamp 字段不是 Integer 类型。
90007 JSON 格式请求包体中 MsgBody 类型不是 Array 类型,请将其修改为 Array 类型。
90008 JSON 格式请求包体中缺少 From_Account 字段,或者From_Account 不存在。
90009 请求需要 App 管理员权限。
90010 JSON 格式请求包不符合消息格式描述,请参考 TIMMsgElement 对象 的定义。
90011 批量发消息目标帐号超过500,请减少 To_Account 中目标帐号数量。
90012 To_Account 没有注册或不存在,请确认 To_Account 是否导入即时通信 IM 或者是否拼写错误。
90026 消息离线存储时间错误(最多不能超过7天)。
90031 JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型。
90044 JSON 格式请求包体中 MsgLifeTime 字段不是 Integer 类型。
90048 请求的用户帐号不存在。
90994 服务内部错误,请重试。
90995 服务内部错误,请重试。
91000 服务内部错误,请重试。
90992 服务内部错误,请重试;如果所有请求都返回该错误码,且 App 配置了第三方回调,请检查 App 服务端是否正常向即时通信 IM 后台服务端返回回调结果。
93000 JSON 数据包超长,消息包体请不要超过8k。
91101 Web 端长轮询被踢(Web 端同时在线实例个数超出限制)。
120001 - 130000 单聊第三方回调返回的自定义错误码。

群组错误码

错误码 描述
10002 服务端内部错误,请重试。
10003 请求中的接口名称错误,请核对接口名称并重试。
10004 参数非法,请根据错误描述检查请求是否正确。
10005 请求包体中携带的帐号数量过多。
10006 操作频率限制,请尝试降低调用的频率。
10007 操作权限不足,例如 Public 群组中普通成员尝试执行踢人操作,但只有 App 管理员才有权限。
10008 请求非法,可能是请求中携带的签名信息验证不正确,请再次尝试或 提交工单 联系技术客服。
10009 该群不允许群主主动退出。
10010 群组不存在,或者曾经存在过,但是目前已经被解散。
10011 解析 JSON 包体失败,请检查包体的格式是否符合 JSON 格式。
10012 发起操作的 Identifier 非法,请检查发起操作的用户 Identifier 是否填写正确。
10013 被邀请加入的用户已经是群成员。
10014 群已满员,无法将请求中的用户加入群组,如果是批量加人,可以尝试减少加入用户的数量。
10015 群组 ID 非法,请检查群组 ID 是否填写正确。
10016 App 后台通过第三方回调拒绝本次操作。
10017 因被禁言而不能发送消息,请检查发送者是否被设置禁言。
10018 应答包长度超过最大包长(1MB),请求的内容过多,请尝试减少单次请求的数据量。
10019 请求的用户帐号不存在。
10021 群组 ID 已被使用,请选择其他的群组 ID。
10023 发消息的频率超限,请延长两次发消息时间的间隔。
10024 此邀请或者申请请求已经被处理。
10025 群组 ID 已被使用,并且操作者为群主,可以直接使用。
10026 该 SDKAppID 请求的命令字已被禁用,请 提交工单 联系客服。
10030 请求撤回的消息不存在。
10031 消息撤回超过了时间限制(默认2分钟)。
10032 请求撤回的消息不支持撤回操作。
10033 群组类型不支持消息撤回操作。
10034 该消息类型不支持删除操作。
10035 音视频聊天室和在线成员广播大群不支持删除消息。
10036 音视频聊天室创建数量超过了限制,请参考 价格说明 购买预付费套餐“IM音视频聊天室”。
10037 单个用户可创建和加入的群组数量超过了限制,请参考 价格说明 购买或升级预付费套餐“单人可创建与加入群组数”。
10038 群成员数量超过限制,请参考 价格说明 购买或升级预付费套餐“扩展群人数上限”。
10041 该应用(SDKAppID)已配置不支持群消息撤回。

(三)IM SDK V3 版本的错误码

错误码 描述
6003 批量操作无成功结果。
6011 无效接收方。
6012 请求超时。
6018 INIT CORE 模块失败。
6020 SessionNode 为 null 。
6023 在登录完成前进行了登出(在登录时返回)。
6024 TLS SDK 未初始化。
6025 TLS SDK 没有找到相应的用户信息。
6100 QALSDK 未知原因BIND失败。
6101 缺少 SSO 票据。
6102 重复 BIND。
6103 TinyId 为空。
6104 GUID 为空。
6105 解注册包失败。
6106 注册超时。
6107 正在 BIND 操作中。
6120 发包未知错误。
6121 发送请求包时没有网络。
6122 发送回复包时没有网络。
6123 发送请求包时没有权限。
6124 SSO 错误。
6125 请求超时。
6126 回复超时。
6127 重发失败。
6128 重发时没有真正发送。
6129 保存被过滤。
6130 发送过载。
6131 数据逻辑错误。
6150 proxy_manager 没有完成服务端数据同步。
6151 proxy_manager 正在进行服务端数据同步。
6152 proxy_manager 同步失败。
6153 proxy_manager 请求参数,在本地检查不合法。
6160 Group assistant 请求字段中包含非预设字段。
6161 Group assistant 群资料本地存储没有开启。
6162 加载群资料失败。
6200 请求的时候没有网络。
6201 响应的时候没有网络。
6205 QALSDK 服务未就绪。
6207 账号认证失败( TinyId 转换失败)。
6209 在应用启动后没有尝试联网。
6210 QALSDK 执行失败。
6211 请求非法,toMsgService 非法。
6212 请求队列满。
6213 已经被其他终端踢了。
6214 服务被暂停。
6215 SSO 签名错误。
6216 SSO cookie 无效。
6217 登录时 TLS SDK 回包校验,包体长度错误。
6218 登录时 OPENSTATSVC 向 OPENMSG 上报状态超时。
6219 登录时 OPENSTATSVC 向 OPENMSG 上报状态时解析回包失败。
6220 登录时 TLS SDK 解密失败。
6221 WIFI 需要认证。
6222 用户已取消。
6223 消息撤回超过了时间限制(默认2分钟)。
6224 缺少 UGC 扩展包。
6226 自动登录,本地票据过期,需要 UserSig 手动登录。
6300 没有可用的短连接 SSO 。
80101 消息内容安全打击。
70101 登录返回,票据过期。
90101 IM SDK 已经初始化无需重复初始化。
115000 OpenBDH 错误码基。
6250 请求时没有网络,请等网络恢复后重试。
6251 响应时没有网络,请等网络恢复后重试。
6252 QALSDK 执行失败。
6253 请求非法,toMsgService 非法。
6254 请求队列満。
6255 已经被其他终端踢了。
6256 服务被暂停。
6257 SSO 签名错误。
6258 SSO cookie 无效。