以下视频将帮助您快速了解即时通信 IM 的错误码：
（一）IM SDK 的错误码
说明：
通用错误码
错误码 | 描述 | 处理建议 |
6015 | 取消当前请求，因为最后一个请求正在运行。 | 请勿并行重复调用，需要等前一次的接口回调后再调用（例如：清空会话未读数、处理群未决、获取黑名单列表 等 API 接口）。 |
6017 | 参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。 | |
6022 | 操作本地 IO 错误，检查是否有读写权限，磁盘是否已满。 | 此错误码通常是权限问题，磁盘剩余空间不足等问题，建议根据错误提示进行排查。 |
6027 | 错误的 JSON 格式，请检查参数是否符合接口的要求，具体可查看错误信息进一步定义哪个字段。 | |
6028 | 内存不足，可能存在内存泄漏，iOS 平台使用 Instrument 工具，Android 平台使用 Profiler 工具，分析出什么地方的内存占用高。 | |
6001 | PB 解析失败，内部错误。 | |
6002 | PB 序列化失败，内部错误。 | |
6013 | IM SDK 未初始化，初始化成功回调之后重试。 | 请先调用 initSDK 接口初始化。 |
6005 | 加载本地数据库操作失败，可能存储文件有损坏。 | |
6019 | 本地数据库操作失败，可能是部分目录无权限或者数据库文件已损坏。 | |
7001 | 跨线程错误，不能在跨越不同线程中执行，内部错误。 | |
7002 | TinyId 为空，内部错误。请检查 UserID 是否存在并有效。 | |
7003 | UserID 不合法。 | 请先确认 UserID 是否为空，且长度是否超过32字节。 |
7004 | 文件不存在，请检查文件路径是否正确。 | |
7005 | 发送富媒体消息，文件大小超出限制。 | 请确认文件大小： 语音、图片，最大限制 28MB 视频、文件，最大限制 100M |
7006 | 发送富媒体消息，文件无效。 | 请确认文件是否为空文件，且文件大小不是0字节。 |
7007 | 文件打开失败，请检查文件是否存在，或者已被独占打开，引起 SDK 打开失败。 | |
7008 | API 调用超频，请检查并避免高频调用接口。 | |
7009 | 正在进行中的操作，因调用 unInitSDK 接口，被意外终止。例如正在登录中，此时调用 unInitSDK 接口，会终止登录操作。 | |
7010 | database 操作失败。 | 请先调用 login 登录接口后，再操作。 |
7011 | database 查询的数据不存在。 | 请确认本地已缓存对应数据。 |
7012 | SDK 内部不应该出现的内部错误 | |
7013 | 套餐包不支持该接口的使用，请升级到旗舰版或企业版套餐。 | |
7014 | 非法请求。请检查接口调用是否符合要求。 | |
7015 | SDK 本地内容审核，命中敏感词。 | 请确认设置的敏感词配置。 |
账号错误码
错误码 | 描述 | 处理建议 |
6014 | IM SDK 未登录，或已被踢下线。 | 请先调用 login登录接口后，再操作。 |
6206 | UserSig 过期 | |
6208 | 其他终端登录同一个账号，引起已登录的账号被踢，需重新登录。 | |
7503 | TLS SDK 初始化失败，内部错误。 | |
7504 | TLS SDK 未初始化，内部错误。 | |
7505 | TLS SDK TRANS 包格式错误，内部错误。 | |
7506 | TLS SDK 解密失败，内部错误。 | |
7507 | TLS SDK 请求失败，内部错误。 | |
7508 | TLS SDK 请求超时，内部错误。 |
消息错误码
错误码 | 描述 | 处理建议 |
6004 | 会话不存在。 | 请确认本地是否存在该会话。 |
6006 | 文件传输鉴权失败，建议检查文件格式是否正确。 | |
6007 | 文件传输获取 Server 列表失败。 | |
6008 | 发送富媒体消息，上传文件失败。 | 请确认 IM 是否已连接，如果上传的是图片，确认图片能够正常打开。 |
6009 | 下载富媒体消息失败。 | 请检查网络，或者文件、语音是否已经过期，目前资源文件存储7天。 |
6010 | HTTP 请求失败。 | 请检查 URL 地址是否合法，可在网页浏览器尝试访问该 URL 地址。 |
6016 | IM SDK 无效消息 elem。 | 请根据返回的错误信息进一步定义哪个字段。 |
6031 | 文件传输上传失败。 | 请检查上传的图片是否能够正常打开。 |
6032 | 无效的消息接收方。 | 请在 IM 控制台检查消息的接收方是否存在。 |
8001 | 消息整体长度超出限制。 | 消息长度不要超过12K，消息长度是各个 elem 长度的总和，elem 长度是所有 elem 字段的长度总和。 |
8002 | 消息 KEY 错误，内部错误，网络请求包的 KEY 和 回复包的不一致。 | |
8003 | 图片转换 HTTP 请求失败。 | |
8004 | 万象优图因为鉴黄等原因转缩略图失败。 | |
8005 | 合并转发消息嵌套层数超出限制。 | 请确认嵌套层数是否超过 100 层。 |
8006 | 消息修改冲突，您请求修改的消息已经被其他人修改。 | 请拿到报错返回的消息体，再次编辑后进行重试。 |
8010 | 信令 ID 无效。 | 请确保信令 ID 正确，且未被处理过。 |
8011 | 信令请求无权限。 | 请确认是否有权限操作，例如取消非自己发起的邀请。 |
8012 | 信令邀请已存在。 | |
8020 | 取消“消息发送”失败。 | 请确保消息存在，且未发送成功。 |
8021 | 消息发送失败。 | 请确认是否因调用“取消发送”接口导致。 |
群组错误码
错误码 | 描述 | 处理建议 |
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人，旗舰版是2000人；增值服务可扩展至6000人，IM 直播群（AVChatroom）和在线成员广播大群无限制。 |
8508 | 不允许申请加入 Private 群组。 | Private 私有群默认不支持申请加入群组，可通过修改群资料更新默认配置。 |
8509 | 不允许邀请角色为群主的成员。 | 请检查角色字段是否填写正确。 |
8510 | 不允许邀请0个成员。 | 请检查成员字段是否填写正确。 |
8511 | 群属性接口调用频率超出限制。 | 群属性增删改接口后台限制1秒5次，查接口 SDK 限制5秒20次。 |
8512 | 群在线人数接口调用频率超出限制。 | SDK 接口频率限制：60秒1次。 |
8513 | 群资料接口调用超出限制。 | SDK 接口频率限制：1秒1次。 |
8514 | 加入群列表接口调用超出限制。 | SDK 接口频率限制：1秒1次。 |
关系链错误码
错误码 | 描述 | 处理建议 |
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 | 调用频率限制。 | 请确认是否有高频调用 SDK 接口，最大每秒发起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 | 请求包已进入 IM SDK 待发送队列，等待进入操作系统的网络层时超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。 | |
9520 | 请求包已由 IM SDK 待发送队列进入操作系统网络层，等待服务端回包超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。 | |
9521 | 请求包已进入待发送队列，部分数据已发送，等待发送剩余部分出现超时，可能上行带宽不足，请检查网络是否畅通，在回调错误时检测有联网。 | |
9522 | 请求包长度大于限制，最大支持 1MB 。 | |
9523 | 请求包已进入待发送队列，等待进入系统的网络 buffer 超时，数据包较多 或 发送线程处理不过来，在回调错误码时检测到没有联网。 | |
9524 | 请求包已进入系统的网络 buffer ，等待服务端回包超时，可能请求包没离开终端设备、中间路由丢弃、服务端意外丢包或回包被系统网络层丢弃，在回调错误码时检测到没有联网。 | |
9525 | 请求包已进入待发送队列，部分数据已发送，等待发送剩余部分出现超时，可能上行带宽不足，请检查网络是否畅通，在回调错误码时检测到没有联网。 |
（二）服务端的错误码
接入层的错误码
错误码 | 描述 | 处理建议 |
-302 | Server 的连接数量超出限制，服务端拒绝服务。 | |
-10001 | Key 过期。Key 是根据 UserSig 生成的内部票据，Key 的有效期小于或等于 UserSig 的有效期。 | 请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。 |
-10003 | Ticket 过期。Ticket 是根据 UserSig 生成的内部票据，Ticket 的有效期小于或等于 UserSig 的有效期。 | 请重新调用 TIMManager.getInstance().login 登录接口生成新的 Ticket。 |
-10004 | 票据验证没通过。 | 请重新调用 TIMManager.getInstance().login 登录接口生成新的票据。 |
-10005 | 不允许空 Key。 | 请重新调用 TIMManager.getInstance().login 登录接口生成 Key。 |
-10006 | Key 中的账号和请求包头的账号不匹配。 | |
-10007 | 验证码下发超时。 | |
-10008 | 需要带上 Key 和 Ticket。 | 请重新调用 TIMManager.getInstance().login 登录接口生成 Key 和 Ticket。 |
-10009 | Cookie 检查不匹配。 | |
-10106 | 解密失败次数超过阈值，通知终端需要重置。 | 请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。 |
-10108 | 预付费欠费。 | - |
-10109 | 请求包格式错误。 | |
-10110 | SDKAppID 在黑名单中。 | |
-10111 | SDKAppID 访问黑名单接口。 | |
-10113 | 频率限制（用户），频率限制是设置针对某一个协议的每秒请求数的限制。 | 请检查接口调用频次是否合理。 |
-10114 | 过载丢包（系统），连接的服务端处理过多请求，处理不过来，拒绝服务。 | |
-20009 | 终端访问接口超频。 | 请检查接口调用频次是否合理。 |
资源文件错误码
错误码 | 描述 | 处理建议 |
114011 | 参数非法。 | 请检查 SDK 接口调用的参数是否正确。 |
后台公共错误码
错误码 | 描述 | 处理建议 |
60002 | HTTP 解析错误 。 | 请检查 HTTP 请求 URL 格式。 |
60003 | HTTP 请求 JSON 解析错误。 | 请检查包体 JSON 格式。 |
60004 | 检查账号失败。 | |
60005 | 检查账号失败。 | |
60007 | REST 接口调用频率超过限制。 | 请控制台自助提升接口频率限制，或降低请求频率。 |
60008 | 服务请求超时或 HTTP 请求格式错误。 | |
60009 | 请求资源错误。 | 请检查请求 URL。 |
60010 | 请求需要 App 管理员权限。 | 请检查请求的 Identifier 是否为管理员。 |
60012 | REST 接口需要带 SDKAppID。 | 请检查请求 URL 中的 SDKAppID。 |
60013 | HTTP 响应包 JSON 解析错误。 | |
60014 | 检查账号超时。 | |
60015 | 请求包体 UserID 类型错误。 | 请确认 UserID 为字符串格式。 |
60016 | SDKAppID 被禁用。 | |
60017 | 请求被禁用。 | |
60018 | 请求过于频繁，请稍后重试。 | 请检查接口调用频次是否合理。 |
60020 | 服务不可用。 | |
60021 | 服务端 REST API 调用来源 IP 非法。 | |
60025 | 服务端 REST API 调用 SDKAppID、Identifier、UserSig 或 ContentType 错误。 | 请检查 URL 参数。 |
60026 | 服务端 REST API 调用域名或 SDKAppID 与应用站不匹配。 | 请检查 SDKAppID 和访问的 IM 站点域名是否一致。 |
60027 | 不允许访问非 TPush 产品资源。 | 请检查创建的产品类型和调用的 REST API 接口产品类型是否一致。 |
60028 | 服务端 REST API 24小时内请求量超过体验版限制。 | - |
80001 | 消息或者资料中文本存在敏感内容，禁止下发。 | 请检查发送内容是否存在敏感信息。 |
80002 | 发消息包体过长，目前支持最大12K消息包体长度。 | 请减少包体大小重试。 |
80003 | - | |
80004 | 消息中图片、音频、视频等文件存在敏感内容，禁止下发。 | 请检查发送内容是否存在敏感信息。 |
80005 | 服务已停用。 |
账号错误码
错误码 | 描述 | 处理建议 |
70001 | UserSig 已过期。 | 请重新生成。建议 UserSig 有效期设置不小于24小时。 |
70003 | 解析失败。 | |
70009 | UserSig 验证失败。 | 怀疑 UserSig 是用其他 SDKAppID 的密钥或私钥生成的，请检查请求的 SDKAppID 和生成 UserSig 的密钥或私钥是否一致。 |
70013 | 请求中的 UserID 与生成 UserSig 时使用的 UserID 不一致 | |
70014 | 请求中的 SDKAppID 与生成 UserSig 时使用的 SDKAppID 不一致。 | |
70016 | 密钥/公钥不存在，UserSig 验证失败。 | 请检查 SDKAppID 和访问的 IM 站点是否一致。 |
70020 | SDKAppID 不存在，UserSig 验证失败。 | 请检查 SDKAppID 和访问的 IM 站点是否一致。 |
70050 | UserSig 验证失败，且请求频率超限。 | 请检查 UserSig 是否正确，并于1分钟后重新验证。 |
70051 | 账号被拉入黑名单。 | |
70107 | 请求的用户账号没有导入即时通信 IM 系统。 | 请先将账号导入即时通信 IM 系统。 |
70169 | 服务端内部超时。 | |
70402 | 请求参数非法。 | 请检查必填字段是否填充，或者字段的填充是否满足协议要求。 |
70404 | SDK 版本过低。 | 请升级到最新版本。 |
70398 | 账号数超限。 | |
70399 | 非 IM 体验版应用，账号被删除后，三个月内不允许重新导入。 | |
70500 | 服务端内部错误。 | |
71000 | 当前应用不支持删除账号。 | |
72000 | 日活跃用户数（DAU）超过免费额度。 | |
72001 | 功能未打开。 | |
72002 | 月活跃用户数（MAU）超过免费额度。 | |
72010 | 请求超频。 | 单用户的登录、登出、切前台、切后台和设置离线推送配置信息请求超过频率限制。 |
72011 | 功能未打开。 | |
72012 | 功能未打开。 |
资料错误码
错误码 | 描述 | 处理建议 |
40001 | 请求参数非法。 | 请检查必填字段是否填充，或者字段的填充是否满足协议要求。 |
40002 | 没有指定需要拉取资料的用户账号。 | 请指定要拉取资料的用户账号。 |
40003 | 请求的用户账号没有导入即时通信 IM 系统。 | 请先将用户账号导入即时通信 IM 系统。 |
40004 | 请求需要 App 管理员权限。 | 请检查请求的 Identifier 是否为管理员。 |
40006 | 服务端内部错误。 | |
40007 | 没有资料字段的读权限。 | |
40008 | 没有资料字段的写权限。 | |
40009 | 资料字段的 Tag 不存在。 | |
40601 | 资料字段的 Value 长度超过500字节。 | |
40605 | 标配资料字段的 Value 非法。 | |
40610 | 资料字段的 Value 类型非法。 |
关系链错误码
错误码 | 描述 | 处理建议 |
30001 | 请求参数非法。 | 请检查必填字段是否填充，或者字段的填充是否满足协议要求。 |
30002 | 请求的用户账号非法。 | 可能 SDK 本地缓存了已删除的账号，建议将 App 卸载重装后重试。 |
30003 | 请求的用户账号没有导入即时通信 IM 系统。 | 请先将用户账号导入即时通信 IM 系统。 |
30004 | 请求需要 App 管理员权限。 | 请检查请求的 Identifier 是否为管理员。 |
30005 | 当前应用没有开启关注与粉丝功能。 | |
30006 | 服务端内部错误。 | |
30007 | 服务端内部超时。 | |
30008 | 并发写导致写冲突。 | 建议使用批量方式。 |
30009 | 后台禁止该用户发起加好友请求。 | |
30010 | 自己的好友数已达系统上限。 | |
30011 | 分组已达系统上限。 | |
30012 | 未决数已达系统上限。 | 如果需要对方同意才能加为好友，建议单次请求添加的好友数不超过100。 |
30013 | 黑名单数已达系统上限。 | |
30014 | 对方的好友数已达系统上限。 | |
30515 | 请求添加好友时，对方在自己的黑名单中，不允许加好友。 | 请先将用户移出黑名单。 |
30516 | 请求添加好友时，对方的加好友验证方式是不允许任何人添加自己为好友。 | |
30525 | 请求添加好友时，自己在对方的黑名单中，不允许加好友。 | 请先将用户移出黑名单。 |
30539 | 待对方同意后才能加为好友。 | A 请求加 B 为好友，B 的加好友验证方式被设置为“AllowType_Type_NeedConfirm”，这时 A 与 B 之间只能形成未决关系，该返回码用于标识加未决成功，以便与加好友成功的返回码区分开，调用方可以捕捉该错误给用户一个合理的提示。 |
30614 | 请求处理的好友申请不存在。 | 请检查待处理的好友申请是否存在。 |
31704 | 与请求删除的账号之间不存在好友关系。 | |
31804 | 请求删除的未决不存在。 | 调用方可以捕捉该错误并给用户一个合理的提示。 |
38000 - 39000 | 关系链第三方回调返回的自定义错误码。 | - |
最近联系人错误码
错误码 | 描述 | 处理建议 |
50001 | 请求的用户账号没有导入即时通信 IM 系统。 | 请先将用户账号导入即时通信 IM 系统。 |
50002 | 请求参数非法。 | 请检查必填字段是否填充，或者字段的填充是否满足协议要求。 |
50003 | 请求需要 App 管理员权限。 | 请检查请求的 Identifier 是否为管理员。 |
50004 | 服务端内部错误。 | |
50005 | 服务端内部超时。 | |
51006 | 请求更新的会话数非法。 | 建议单次请求的会话数不超过100。 |
51007 | G2C 会话校验权限失败。 | 请稍后重试。如果仍然失败，请检查用户是否是已退群。 |
51008 | 分组/标记的会话数已达系统上限。 | |
51009 | 请求删除的会话分组不存在。 | |
51010 | 会话分组已达系统上限。 | |
51011 | 会话分组名超过了32个字节。 | 分组名长度不得超过32个字节。 |
51012 | 置顶的会话数已达系统上限。 | 置顶会话数上限为50，且不支持增加。 |
消息错误码
错误码 | 描述 | 处理建议 |
20001 | 请求包非法。 | |
20002 | UserSig 或 A2 失效。 | 重新登录。 |
20003 | 消息发送方或接收方 UserID 无效或不存在。 | - |
20004 | 网络异常，请重试。 | - |
20005 | 服务端内部错误，请重试。 | - |
20006 | 消息禁止下发。 | 触发发送单聊消息之前回调，App 后台返回禁止下发该消息。 |
20007 | 发送方被拉黑，消息禁止发送。 | 发送单聊消息，被对方拉黑，禁止发送。 |
20008 | 消息发送方和接收方属于不同的 SDKAppID。原因是客户端切换了 SDKAppID，但数据库未进行清理。解决办法是在切换 SDKAppID 时删除原来的数据库。 | 清理客户端缓存及数据，重新安装客户端。 |
20009 | 收发双方非好友，禁止发送。 | 消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现）。 |
20010 | 发送方不是接收方好友，禁止发送。 | 发送单聊消息，自己不是对方的好友（单向关系），禁止发送。 |
20011 | 接收方不是发送方好友，禁止发送。 | 发送单聊消息，对方不是自己的好友（单向关系），禁止发送。 |
20012 | 发送方被禁言，该禁止发送。 | 发送方被禁言，该条消息被禁止发送。 |
20016 | 超过撤回时间限制。 | 消息撤回超过了时间限制（默认2分钟）。 |
20018 | 内部错误。 | |
20022 | 消息不存在。 | 该待撤回的消息不存在，请检查。 |
20023 | 消息已撤回。 | 该消息已被撤回。 |
20027 | 消息版本号冲突，请获取最新消息后重试。 | - |
20028 | 并发修改消息导致冲突，请重试。 | - |
21005 | 设置 token 请求比登录请求先到后台，请确保先登录，后设置 token。 | - |
22001 | 没有上传过任何离线推送证书。 | 在控制台打开离线推送功能，并上传对应证书。 |
22002 | 网络异常，请重试。 | |
22003 | 上传的 token 为空。 | 设置的 Token 长度为0 ，请检查。 |
22004 | 上传的 token 长度超过256字节。 | 设置的 Token 长度大于256字节，请检查 。 |
22006 | 请求超频。 | 降低对应操作的频率。 |
22007 | 日活跃用户数（DAU）超过免费额度。 | |
90001 | JSON 格式解析失败，请检查请求包是否符合 JSON 规范。 | 使用 JSONLint 之类的工具检查 JSON 是否有语法错误。 |
90002 | 请求格式错误。 | |
90003 | To_Account 字段错误。 | JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 账号不存在。 |
90005 | MsgRandom 字段错误。 | JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型。 |
90006 | MsgTimeStamp 字段错误。 | JSON 格式请求包体中缺少 MsgTimeStamp 字段或者 MsgTimeStamp 字段不是 Integer 类型。 |
90007 | MsgBody 字段错误。 | JSON 格式请求包体中 MsgBody 类型不是 Array 类型，请将其修改为 Array 类型。 |
90008 | From_Account 字段错误。 | JSON 格式请求包体中缺少 From_Account 字段或者 From_Account 账号不存在。 |
90009 | 请求需要 App 管理员权限。 | Rest API URL 中 identifier 字段必须为管理员账号。 |
90010 | 请求格式错误。 | |
90011 | 目标账号超过500。 | 批量发消息目标账号超过500，请减少 To_Account 中目标账号数量。 |
90012 | To_Account 字段错误。 | To_Account 没有注册或不存在，请确认 To_Account 是否导入即时通信 IM 或者是否拼写错误。 |
90018 | 请求的账号数量超过限制。 | - |
90022 | 推送条件中的 TagsOr 和 TagsAnd 有重复标签。 | - |
90024 | 推送过于频繁，每两次推送间隔必须大于1秒。 | - |
90026 | MsgLifeTime 字段错误。 | 请求 JSON 中，MsgLifeTime 值过大。 |
90028 | To_Account 字段错误。 | 批量发单聊消息的 To_Account 字段不是数组类型，请修改为数组类型。 |
90029 | To_Account 字段错误。 | 批量发单聊消息的 To_Account 数组大小为0，请在 To_Account 数组中填入账号。 |
90030 | SyncFromOldSystem 字段错误。 | |
90031 | SyncOtherMachine 字段错误。 | JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型。 |
90032 | 推送条件中的 tag 数量大于10，或添加标签请求中的标签数量大于10。 | - |
90033 | 属性无效。 | |
90034 | 标签长度大于50。 | |
90040 | 推送条件中其中1个 tag 为空。 | - |
90043 | OfflinePushInfo 字段错误。 | |
90044 | MsgLifeTime 字段错误。 | JSON 格式请求包体中 MsgLifeTime 字段不是 Integer 类型。 |
90045 | 未开通全员推送功能。 | |
90047 | 推送次数超过当天限额（默认为100次）。 | |
90048 | 用户账号不存在。 | |
90054 | MsgKey 字段错误。 | |
90055 | 批量发消息的包体过长，目前支持最大12K消息包体长度。 | |
90994 | 服务内部错误，请重试。 | |
90995 | 服务内部错误，请重试。 | |
91000 | 服务内部错误，请重试。 | |
90992 | 消息回调错误。 | 服务内部错误，请重试；如果所有请求都返回该错误码，且 App 配置了第三方回调，请检查 App 服务端是否正常向即时通信 IM 后台服务端返回回调结果。 |
93000 | JSON 数据包超长，消息包体请不要超过12K。 | |
91101 | Web 端长轮询被踢（Web 端同时在线实例个数超出限制）。 | |
90057 | 降低对应操作的频率，或在控制台调高批量发单聊频率限制。 | |
120001 - 130000 | 单聊第三方回调返回的自定义错误码。 | - |
群组错误码
错误码 | 描述 | 处理建议 |
10002 | 服务端内部错误。 | 请重试。 |
10003 | 请求中的接口名称错误。 | 请核对接口名称并重试。 |
10004 | 参数非法。 | 请根据错误描述检查请求是否正确。 |
10005 | 请求包体中携带的账号数量过多。 | 减少包体中携带账号的数量。 |
10006 | 操作频率达到上限。 | 请尝试降低调用的频率。 |
10007 | 常见的原因有： 操作的群默认不支持此操作，请检查当前群类型。 操作账号的权限不够（例如封禁操作中，管理员可以封禁普通成员但不能封禁群主）。 调用 RestAPI 的账号不是 SDKAppID 的管理员账号。 | |
10009 | 该群不允许群主主动退出。 | 检查请求中退群的成员是否为群主。 |
10010 | 群组不存在，或者曾经存在过，但是目前已经被解散。 | 群不存在，无法操作。 |
10011 | 解析 JSON 包体失败。 | 请检查包体的格式是否符合 JSON 格式。 |
10012 | 发起操作的 UserID 非法。 | 请检查发起操作的用户 UserID 是否填写正确。 |
10013 | 用户已经是群成员。 | 已经是群内成员，无需重复添加。 |
10014 | 群已满员，无法将请求中的用户加入群组。 | 如果是批量加人，可以尝试减少加入用户的数量。 |
10015 | 群组不存在或已经被解散。 | - |
10016 | App 后台通过第三方回调拒绝本次操作。 | 请检查 App 后台是否回报率拦截本次操作。 |
10017 | 被禁言而不能发送消息。 | 请检查发送者是否被设置禁言。 |
10018 | 应答包长度超过最大包长（1MB），请求的内容过多。 | 请尝试减少单次请求的数据量。 |
10019 | 请求的用户账号不存在。 | 请检查请求体中的 UserID 是否填写正确。 |
10021 | 群组 ID 已被使用。 | 请选择其他的群组 ID。 |
10023 | 发消息的频率超限，触发单群每秒40条频控。 | 请延长两次发消息时间间隔，或根据业务需求设置消息优先级。 |
10024 | 此邀请或者申请请求已经被处理。 | 无需重复处理邀请或申请请求。 |
10025 | 群组 ID 已被使用，并且操作者为群主。 | 直接使用此群组 ID 即可。 |
10026 | 该 SDKAppID 请求的命令字已被禁用。 | - |
10030 | 请求撤回的消息不存在。 | 检查填写的消息 seq 是否正确。 |
10031 | 消息撤回超过了时间限制（默认2分钟）。 | 请在时间限制内对消息进行撤回（默认2分钟内）。 |
10032 | 请求撤回的消息不支持撤回操作。 | 请检查要撤回的消息是否支持撤回。 |
10033 | 群组类型不支持消息撤回操作。 | 请检查此群组类型是否支持消息撤回。 |
10034 | 该消息类型不支持删除操作。 | 请检查请求中消息对应的类型是否支持删除。 |
10035 | IM 直播群和在线成员广播大群不支持删除消息。 | 请不要删除 IM 直播群和在线成员广播大群消息。 |
10036 | IM 直播群创建数量超过了限制。 | |
10037 | 单个用户可创建和加入的群组数量超过了限制。 | |
10038 | 群成员数量超过限制。 | |
10041 | 该应用（SDKAppID）已配置不支持群消息撤回。 | 请检查群消息是否支持撤回操作。 |
10044 | 表示该群类型不支持获取漫游，例如：AVChatRoom。 | 请检查操作的群类型是否支持获取漫游。 |
10045 | 自定义属性 key 超过大小限制32字节。 | 请缩减自定义属性 key 大小。 |
10046 | 自定义属性单个 val 超过了大小限制4000字节。 | 请缩减自定义属性单个 val 大小。 |
10047 | 自定义属性 key 数量超过了限制16。 | 请缩减自定义属性 key 数量。 |
10048 | 自定义属性所有 key 对应的 val 大小之和超过上限16000字节。 | 请缩减所有 key 对应的 val 大小。 |
10049 | 自定义属性写操作触发频控。 | 延长两次自定义属性写操作之间的时间间隔。 |
10050 | 删除不存在的自定义属性。 | 请检查删除的自定义属性是否存在。 |
10051 | 消息删除超过最大范围限制。 | 缩小请求中要删除的消息 seq 最大值和最小值之差。 |
10052 | 消息删除时候群里不存在消息。 | 检查群中是否存在消息。 |
10053 | 群@数量超过上限30。 | 减少@群成员的数量，可分批进行@。 |
10054 | 群成员过多。 | 请分页拉取。 |
10056 | 自定义属性写操作竞争冲突。 | 请获取最新的自定义属性后再进行写操作。 |
10058 | 体验版超过100个群的限制。 | 需要购买套餐包提升建群数量限制。 |
10059 | 该特性需要购买旗舰版或企业版才可以支持。 | |
10060 | 群人数超过已读回执群上限。 | 请检查群人数是否超过已读回执可支持上限 |
10061 | 在线消息不支持已读回执。 | 请检查发消息请求中是否令消息为在线消息并需要已读回执。 |
10062 | 已读回执信息不存在。 | 发消息时应设置需要已读回执。 |
10063 | 群计数器 Key 数量超过限制，最大为20个。 | 请精简群计数器 Key 数量。 |
10070 | 置顶消息超出数量限制。 | 请检查置顶消息数量是否超过最大限制。 |
11000 | 未开通社群功能。 | 开通社群后相关功能会支持。 |
110006 | 权限组不存在，或者曾经存在过，但是目前已经被解散。 | - |
110007 | 权限组删除失败。 | 请重试。 |
110008 | 权限组不存在或已被删除。 | 更换权限组 ID 后重试。 |
110010 | 该话题在相应的权限组已经存在。 | 更换权限组 ID 或话题 ID 后重试 |
110011 | 该话题在相应的权限组不存在。 | 更换权限组 ID 或话题 ID 后重试。 |
110012 | 权限组成员数量超过限制。 | 减少权限组成员后重试。 |
110013 | 无效的话题 ID。 | 更换话题 ID。 |
110014 | 该话题权限已被删除。 | 更换权限组ID或话题ID后重试。 |
离线推送错误码
获取运营数据错误码
错误码 | 描述 |
1001 | 参数非法；请检查是否管理员账号，必填字段是否填充，或者字段的填充是否满足协议要求。 |
1003 | |
1004 | 文件尚未生成，或者请求时间段内没有消息。 |
1005 | 文件已过期。 |
内容审核错误码
错误码 | 描述 | 处理建议 |
2001 | 请稍后重试。 | |
2002 | 暂不支持该命令字。 | - |
2003 | 请求参数无效。 | - |
2004 | 该请求没有权限。 | 检查 RestAPI 是否管理员调用。 |
2015 | 未开启审核服务。 | - |
2016 | 添加脏词超过每次请求的限制。 | 每次最多添加10个关键词。 |
2100 | 删除云端审核敏感词失败。 | - |
93000 | 送审内容超过了最大限制 8KB。 | 请检查 Content 内容长度。 |
93001 | 请求内部错误。 | |
93005 | 批量审核接口。 | 只支持图文审核。 |
93006 | 批量审核接口。 | 存在审核超时，超时时间为5s。 |
93007 | 批量审核接口。 | 不支持重复的 ContentId。 |
93008 | 批量审核接口。 | 一次最多支持10个 Content 送审。 |
公众号错误码
错误码 | 含义说明 | 处理建议 |
130002 | 操作权限不足，请根据错误信息检查请求参数。 | 请检查请求用户是否已经订阅该公众号或者拥有对该公众号的管理权限。 |
130004 | 公众号用户不存在，或者曾经存在过，但是目前已经被销毁。 | - |
130005 | 该用户已经订阅该公众号，请勿重复订阅。 | - |
130006 | 此公众号的订阅者人数已满。 | |
130007 | 公众号用户 ID 不符合格式要求。 | |
130008 | 公众号用户 ID 已经被使用。 | 请修改后重试。 |
130009 | 该公众号不支持删除消息。 | - |
130010 | 超过预付费创建和加入公众号数量限制。 | 请取消部分公众号订阅再重试。 |
131000 | 此 AppId 暂未开通公众号服务。 | |
130010 | 创建的公众号数量超过限制。 | 请解散部分公众号再重试。 |
131003 | 订阅信息未找到，该用户可能没有订阅该公众号。 | 请检查请求用户是否已经订阅该公众号。 |
131005 | 该 SDK 版本过低，不支持公众号功能，请升级 SDK 版本。 | - |
（三）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 转换失败），请检查 UserID 是否存在并有效。 |
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 。 |
70101 | 登录返回，票据过期。 |
90101 | IM SDK 已经初始化无需重复初始化。 |
115000 | OpenBDH 错误码。 |
6250 | 请求时没有网络，请等网络恢复后重试。 |
6251 | 响应时没有网络，请等网络恢复后重试。 |
6252 | QALSDK 执行失败。 |
6253 | 请求非法，toMsgService 非法。 |
6254 | 请求队列满。 |
6255 | 已经被其他终端踢了。 |
6256 | 服务被暂停。 |
6257 | SSO 签名错误。 |
6258 | SSO cookie 无效。 |
说明：
