Tencent Cloud

Recent Pages

错误码

最后更新时间：2024-04-23 17:11:57

（一）IM SDK 的错误码
说明
Web SDK 相关的错误码请参见 错误码对照表。 
通用错误码
错误码
描述
4001
文件消息失败，对应 URL 不是 IM 分配的存储资源。
4002
文件消息失败，内部服务器网络错误。
4003
图片消息失败，数据万象返回格式错误。
4004
图片消息失败，无效的图片格式。
4005
文件消息失败，禁止发送违规封禁的文件。
6015
执行中，请做好接口调用控制。例如，第一次初始化操作在回调前，后续的初始化操作会返回该错误码。
6017
参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。
6022
操作本地 IO 错误，检查是否有读写权限，磁盘是否已满。
6027
错误的 JSON 格式，请检查参数是否符合接口的要求，具体可查看错误信息进一步定义哪个字段。
6028
内存不足，可能存在内存泄漏，iOS 平台使用 Instrument 工具，Android 平台使用 Profiler 工具，分析出什么地方的内存占用高。
6001
PB 解析失败，内部错误。
6002
PB 序列化失败，内部错误。
6013
IM SDK 未初始化，初始化成功回调之后重试。
6005
加载本地数据库操作失败，可能存储文件有损坏。
6019
本地数据库操作失败，可能是部分目录无权限或者数据库文件已损坏。
7001
跨线程错误，不能在跨越不同线程中执行，内部错误。
7002
TinyId 为空，内部错误。请检查 UserID 是否存在并有效。
7003
UserID 非法，必须不为空，要求可打印 ASCII 字符（0x20-0x7e），长度不超过32字节。
7004
文件不存在，请检查文件路径是否正确。
7005
文件大小超出了限制，如果上传文件，最大限制是100MB。
7006
空文件，要求文件大小不是0字节，如果上传图片、语音、视频或文件，请检查文件是否正确生成。
7007
文件打开失败，请检查文件是否存在，或者已被独占打开，引起 SDK 打开失败。
7008
API 调用超频，请检查并避免高频调用接口。
7009
正在执行时被终止，例如正在登录时，调用 unInit 停止使用 SDK。
7010
database 操作失败。
7011
database 查询的数据不存在。
7012
SDK 内部不应该出现的内部错误
7013
套餐包不支持该接口的使用，请升级到进阶版套餐。
7014
非法请求。请检查接口调用是否符合要求。
7015
SDK 本地内容审核，命中敏感词。
账号错误码
错误码
描述
6014
IM SDK 未登录，请先登录，成功回调之后重试，或者已被踢下线，可使用 TIMManager getLoginUser 检查当前是否在线。
6026
自动登录时，并没有登录过该用户，这时候请调用 login 接口重新登录。
6206
UserSig 过期，请重新获取有效的 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
文件传输上传失败，请检查网络是否连接，如果上传的是图片，确认图片能够正常打开。
6031
文件传输上传失败，请检查上传的图片是否能够正常打开。
6009
文件传输下载失败，请检查网络，或者文件、语音是否已经过期，目前资源文件存储7天。
6010
HTTP 请求失败，请检查 URL 地址是否合法，可在网页浏览器尝试访问该 URL 地址。
6016
IM SDK 无效消息 elem，具体可查看错误信息进一步定义哪个字段。
6021
无效的对象，例如用户自己生成 TIMImage 对象，或内部赋值错误导致对象无效。
8001
消息长度超出限制，消息长度不要超过12K，消息长度是各个 elem 长度的总和，elem 长度是所有 elem 字段的长度总和。
8002
消息 KEY 错误，内部错误，网络请求包的 KEY 和 回复包的不一致。
8003
图片转换 HTTP 请求失败。
8004
万象优图因为鉴黄等原因转缩略图失败。
8005
合并转发消息嵌套层数超过上限100层。
8006
消息修改冲突，您请求修改的消息已经被其他人修改。
8010
信令请求 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人，音视频聊天室和在线成员广播大群无限制。
8508
不允许申请加入 Private 群组，任意群成员可邀请入群，且无需被邀请人同意。
8509
不允许邀请角色为群主的成员，请检查角色字段是否填写正确。
8510
不允许邀请0个成员，请检查成员字段是否填写正确。
8511
群属性接口操作限制：增删改接口后台限制1秒5次，查接口 SDK 限制5秒20次。
8512
获取群在线人数接口操作限制：查接口 SDK 限制60秒1次。
8513
获取群资料接口操作限制：查接口 SDK 限制1秒1次。
8514
获取加入群列表接口操作限制：查接口 SDK 限制1秒1次。
8515
不允许标记群成员。
关系链错误码
错误码
描述
9001
资料字段非法，资料支持标配字段及自定义字段，其中自定义字段的关键字，必须是英文字母，且长度不得超过8字节，自定义字段的值最长不能超过500字节。
9002
备注字段非法，最大96字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
9003
请求添加好友的请求说明字段非法，最大120字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
9004
请求添加好友的添加来源字段非法，来源需要添加“AddSource_Type_”前缀。
9005
好友分组字段非法，必须不为空，每个分组的名称最长30字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
9006
超过数量限制。
网络错误码
错误码
描述
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
请求包已进入 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。
-10006
Key 中的账号和请求包头的账号不匹配。
-10007
验证码下发超时。
-10008
需要带上 Key 和 Ticket。
-10009
Cookie 检查不匹配。
-10106
解密失败次数超过阈值，通知终端需要重置，请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。
-10108
预付费欠费。
-10109
请求包格式错误。
-10110
SDKAppID 黑名单。
-10111
SDKAppID 设置 service cmd 黑名单。
-10112
SDKAppID 停用。
-10113
频率限制(用户)，频率限制是设置针对某一个协议的每秒请求数的限制。
-10114
过载丢包(系统)，连接的服务端处理过多请求，处理不过来，拒绝服务。
-20009
终端访问接口超频。
资源文件错误码
错误码
描述
114000
要发送的资源文件不存在。
114001
要发送的资源文件不允许访问。
114002
文件大小超过限制。
114003
用户取消发送，如发送过程中登出等原因。
114004
读取文件内容失败。
114005
资源文件（如图片、文件、语音、视频）传输超时，一般是网络问题导致。
114011
参数非法。
115066
文件 MD5 校验失败。
115068
分片 MD5 校验失败。
后台公共错误码
错误码
描述
60002
HTTP 解析错误 ，请检查 HTTP 请求 URL 格式。
60003
HTTP 请求 JSON 解析错误，请检查 JSON 格式。
60004
请求 URI 或 JSON 包体中 UserID 或 UserSig 错误。
60005
请求 URI 或 JSON 包体中 UserID 或 UserSig 错误。
60006
SDKAppID 失效，请核对 SDKAppID 有效性。
60007
REST 接口调用频率超过限制，请降低请求频率。
60008
服务请求超时或 HTTP 请求格式错误，请检查并重试。
60009
请求资源错误，请检查请求 URL。
60010
REST API 请求的 UserID 字段请填写 App 管理员账号。
60011
SDKAppID 请求频率超限，请降低请求频率。
60012
REST 接口需要带 SDKAppID，请检查请求 URL 中的 SDKAppID。
60013
HTTP 响应包 JSON 解析错误。
60014
置换账号超时。
60015
请求包体 UserID 类型错误，请确认 UserID 为字符串格式。
60016
SDKAppID 被禁用。
60017
请求被禁用。
60018
请求过于频繁，请稍后重试。
60019
请求过于频繁，请稍后重试。
60020
服务不可用。如未购买基础服务套餐包或套餐包过期失效，请购买基础服务套餐包；如腾讯云账号欠费，请充值结清欠款。
60021
RestAPI 调用来源 IP 非法。
60025
RestAPI 调用 SDKAppID、Identifier、UserSig 或 ContentType 错误，请检查 URL 参数。
60026
RestAPI 调用域名或 SDKAppID 与应用站不匹配。
80001
消息或者资料中文本存在敏感内容，禁止下发。
80002
发消息包体过长，目前支持最大12K消息包体长度，请减少包体大小重试。
80003
发单聊消息前回调或发群聊消息前回调失败或回包超时，消息不下发。可在控制台自助配置 事件发生之前回调超时的处理策略。
80004
消息中图片存在敏感内容，禁止下发。
账号错误码
错误码
描述
70001
UserSig 已过期，请重新生成。建议 UserSig 有效期设置不小于24小时。
70002
UserSig 长度为0，请检查传入的 UserSig 是否正确。
70003
UserSig 非法，请使用官网提供的 API 重新 生成 UserSig。
70005
UserSig 非法，请使用官网提供的 API 重新 生成 UserSig。
70009
UserSig 验证失败，可能因为生成 UserSig 时混用了其他 SDKAppID 的私钥或密钥导致，请使用对应 SDKAppID 下的私钥或密钥重新 生成 UserSig。
70013
请求中的 UserID 与生成 UserSig 时使用的 UserID 不匹配，您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
70014
请求中的 SDKAppID 与生成 UserSig 时使用的 SDKAppID 不匹配，您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
70016
公钥不存在，UserSig 验证失败，请在即时通信 IM 控制台 获取密钥。
70020
SDKAppID 未找到，请在即时通信 IM 控制台确认应用信息。
70050
UserSig 验证次数过于频繁。请检查 UserSig 是否正确，并于1分钟后重新验证。您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
70051
账号被拉入黑名单。
70107
请求的用户账号不存在。
70114
因安全原因被限制登录，请不要频繁登录。
70169
服务端内部超时，请稍后重试。
70202
服务端内部超时，请稍后重试。
70206
请求中批量数量不合法。
70402
参数非法，请检查必填字段是否填充，或者字段的填充是否满足协议要求。

70404

您使用的SDK版本太低，请升级到最新版本。
70403
请求失败，需要 App 管理员权限。
70398
账号数超限。如需创建多于100个账号，请将应用升级，具体操作指引请参见 购买指引。
70500
服务端内部错误，请稍后重试。
71000
删除账号失败。仅支持删除体验版账号，您当前应用暂不支持账号删除。
72000
您当前应用为体验版，日活跃用户数（DAU）超过免费额度。若需解除该限制，请将应用升级为专业版或旗舰版，具体操作指引请参见 购买指引。
72001
请在控制台开启用户状态查询及状态变更通知配置，具体操作指引请参见 操作指引

72002
您当前应用为开发版，月活跃用户数（MAU）超过免费额度。若需解除该限制，请将应用升级为标准版或进阶版，具体操作指引请参见购买指引。

72010
单用户的登录、登出、切前台、切后台和设置离线推送配置信息请求超过频率限制。
72011
请在 控制台 > 登录与消息 开启全局消息免打扰相关的配置。
72012
请在控制台开启用户资料变更订阅配置，具体操作指引请参见 操作指引。
资料错误码
错误码
描述
40001
请求参数错误，请根据错误描述检查请求是否正确。
40002
请求参数错误，没有指定需要拉取资料的用户账号。
40003
请求的用户账号不存在。
40004
请求需要 App 管理员权限。
40006
服务端内部错误，请稍后重试。
40007
没有资料字段的读权限，详情可参见 资料字段。
40008
没有资料字段的写权限，详情可参见 资料字段。
40009
资料字段的 Tag 不存在。
40601
资料字段的 Value 长度超过500字节。
40605
标配资料字段的 Value 错误，详情可参见 标配资料字段。
40610
资料字段的 Value 类型不匹配，详情可参见 标配资料字段。
关系链错误码
错误码
描述
30001
请求参数错误，请根据错误描述检查请求是否正确。
30002
SDKAppID 不匹配。
30003
请求的用户账号不存在。
30004
请求需要 App 管理员权限。
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
网络超时，请稍后重试。
51006
修改会话标记时，调整的会话数为空或者超过了100个上限。
51007
GroupID 换 GroupCode 失败，内部错误或 Group 已经解散。
51008
会话分组的总的会话数超过了1000。
51009
删除会话分组时分组不存在。
51010
会话分组数超过了20个上限。
51011
会话分组名超过了32个字节。
51012
超过置顶会话数量上限。置顶会话数上限为50，不支持增加。
消息错误码
错误码
描述
20001
请求包非法。
20002
UserSig 或 A2 失效。
20003
消息发送方或接收方 UserID 无效或不存在，请检查 UserID 是否已导入即时通信 IM。
20004
网络异常，请重试。
20005
服务端内部错误，请重试。
20006
触发发送单聊消息之前回调，App 后台返回禁止下发该消息。
20007
发送单聊消息，被对方拉黑，禁止发送。 
消息发送状态默认展示为失败，您可以登录控制台修改该场景下的消息发送状态展示结果，具体操作请参见 黑名单检查。
20008
消息发送方和接收方属于不同的 SDKAppID。原因是客户端切换了 SDKAppID，但数据库未进行清理。解决办法是在切换 SDKAppID 时删除原来的数据库。
20009
消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现）。
20010
发送单聊消息，自己不是对方的好友（单向关系），禁止发送。
20011
发送单聊消息，对方不是自己的好友（单向关系），禁止发送。
20012
发送方被禁言，该条消息被禁止发送。
20016
消息撤回超过了时间限制（默认2分钟）。
20018
删除漫游内部错误。
20022
该待撤回的消息不存在，请检查。
20023
该消息已被撤回。
20028
并发修改消息导致冲突，请重试。
21005
设置 token 请求比登录请求先到后台，请确保先登录，后设置 token。
22001
没有上传过任何离线推送证书。
22002
网络异常，请重试。
22003
上传的 token 为空。
22004
上传的 token 长度超过256字节。
22005
登录请求数据超过1024字节。
22006
请求超频。
90001
JSON 格式解析失败，请检查请求包是否符合 JSON 规范。
90002
JSON 格式请求包中 MsgBody 不符合消息格式描述，或者 MsgBody 不是 Array 类型，请参考 TIMMsgElement 对象 的定义。
90003
JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 账号不存在。
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 或者是否拼写错误。
90018
请求的账号数量超过限制。
90022
推送条件中的 TagsOr 和 TagsAnd 有重复标签。
90024
推送过于频繁，每两次推送间隔必须大于1秒。
90026
消息离线存储时间错误（最多不能超过7天）。
90030
属性长度为0或大于50。
90031
JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型。
90032
推送条件中的 tag 数量大于10，或添加标签请求中的标签数量大于10。
90033
属性无效。
90034
标签长度大于50。
90040
推送条件中其中1个 tag 为空。
90043
JSON 格式请求包中 OfflinePushInfo 不符合消息格式描述，请参考 OfflinePushInfo 对象 的定义。
90044
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
操作权限不足（例如 Public 群组中普通成员尝试执行踢人操作，但只有 App 管理员才有权限；或者非群成员操作）。
10009
该群不允许群主主动退出。
10010
群组不存在，或者曾经存在过，但是目前已经被解散。
10011
解析 JSON 包体失败，请检查包体的格式是否符合 JSON 格式。
10012
发起操作的 UserID 非法，请检查发起操作的用户 UserID 是否填写正确。
10013
用户已经是群成员。
10014
群已满员，无法将请求中的用户加入群组，如果是批量加人，可以尝试减少加入用户的数量。
10015
无效的群组 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）已配置不支持群消息撤回。
10044
表示该群类型不支持获取漫游，例如：AVChatRoom
10045
自定义属性 key 超过大小限制32字节。
10046
自定义属性单个 val 超过了大小限制4000字节。
10047
自定义属性 key 数量超过了限制16。
10048
自定义属性所有 key 对应的 val 大小之和超过上限16000字节。
10049
自定义属性写操作触发频控。
10050
删除不存在的自定义属性。
10051
消息删除超过最大范围限制。
10052
消息删除时候群里不存在消息。
10053
群@数量超过上限30。
10054
群成员过多，请分页拉取。
10056
自定义属性写操作竞争冲突，请获取最新的自定义属性后再进行写操作。
10058
表示体验版超过100个群的限制，需要购买套餐包提升建群数量限制。
10059
该特性需要购买进阶版才可以支持。
10060
群人数超过已读回执群上限。
10061
在线消息不支持已读回执。
10062
已读回执信息不存在。
10062
已读回执信息不存在。
10063
群计数器 Key 数量超过限制，最大为20个。
10070
置顶消息超出数量限制。
11000
未开通社群功能。
离线推送错误码
错误码
描述
-195
谷歌推送构建推送对象失败，通常是证书错误导致。
-196
参数缺失，选择了 intent，但是没有设置 intent 的值。
-197
证书错误，请检查证书相关参数排查。
-198
厂商响应错误。
-199
厂商网络异常。
-200
IM 后台网络错误。
-201
合法性检查没有通过，例如 token 或者证书 ID 错误。
-202
在推送给厂商之前，构建对象失败。
-203
华为日推送限制。
获取运营数据错误码
错误码
描述
1001
请求非法；请检查“请求 URL”是否正确。
1002
参数非法；请检查是否管理员账号，必填字段是否填充，或者字段的填充是否满足协议要求。
1003
系统错误。
1004
文件尚未生成，或者请求时段内没有消息。
1005
文件已过期。
（三）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 无效。
注意
如问题仍无法解决，您可以 提交工单 提供使用接口、错误码以及错误信息给技术支持人员解决。
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

错误码

（一）IM SDK 的错误码

通用错误码

账号错误码

消息错误码

群组错误码

关系链错误码

网络错误码

（二）服务端的错误码

接入层的错误码

资源文件错误码

后台公共错误码

账号错误码

资料错误码

关系链错误码

最近联系人错误码

消息错误码

群组错误码

离线推送错误码

获取运营数据错误码

（三）IM SDK V3 版本的错误码

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

错误码	描述
4001	文件消息失败，对应 URL 不是 IM 分配的存储资源。
4002	文件消息失败，内部服务器网络错误。
4003	图片消息失败，数据万象返回格式错误。
4004	图片消息失败，无效的图片格式。
4005	文件消息失败，禁止发送违规封禁的文件。
6015	执行中，请做好接口调用控制。例如，第一次初始化操作在回调前，后续的初始化操作会返回该错误码。
6017	参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。
6022	操作本地 IO 错误，检查是否有读写权限，磁盘是否已满。
6027	错误的 JSON 格式，请检查参数是否符合接口的要求，具体可查看错误信息进一步定义哪个字段。
6028	内存不足，可能存在内存泄漏，iOS 平台使用 Instrument 工具，Android 平台使用 Profiler 工具，分析出什么地方的内存占用高。
6001	PB 解析失败，内部错误。
6002	PB 序列化失败，内部错误。
6013	IM SDK 未初始化，初始化成功回调之后重试。
6005	加载本地数据库操作失败，可能存储文件有损坏。
6019	本地数据库操作失败，可能是部分目录无权限或者数据库文件已损坏。
7001	跨线程错误，不能在跨越不同线程中执行，内部错误。
7002	TinyId 为空，内部错误。请检查 UserID 是否存在并有效。
7003	UserID 非法，必须不为空，要求可打印 ASCII 字符（0x20-0x7e），长度不超过32字节。
7004	文件不存在，请检查文件路径是否正确。
7005	文件大小超出了限制，如果上传文件，最大限制是100MB。
7006	空文件，要求文件大小不是0字节，如果上传图片、语音、视频或文件，请检查文件是否正确生成。
7007	文件打开失败，请检查文件是否存在，或者已被独占打开，引起 SDK 打开失败。
7008	API 调用超频，请检查并避免高频调用接口。
7009	正在执行时被终止，例如正在登录时，调用 unInit 停止使用 SDK。
7010	database 操作失败。
7011	database 查询的数据不存在。
7012	SDK 内部不应该出现的内部错误
7013	套餐包不支持该接口的使用，请升级到进阶版套餐。
7014	非法请求。请检查接口调用是否符合要求。
7015	SDK 本地内容审核，命中敏感词。

错误码	描述
6014	IM SDK 未登录，请先登录，成功回调之后重试，或者已被踢下线，可使用 TIMManager getLoginUser 检查当前是否在线。
6026	自动登录时，并没有登录过该用户，这时候请调用 login 接口重新登录。
6206	UserSig 过期，请重新获取有效的 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	文件传输上传失败，请检查网络是否连接，如果上传的是图片，确认图片能够正常打开。
6031	文件传输上传失败，请检查上传的图片是否能够正常打开。
6009	文件传输下载失败，请检查网络，或者文件、语音是否已经过期，目前资源文件存储7天。
6010	HTTP 请求失败，请检查 URL 地址是否合法，可在网页浏览器尝试访问该 URL 地址。
6016	IM SDK 无效消息 elem，具体可查看错误信息进一步定义哪个字段。
6021	无效的对象，例如用户自己生成 TIMImage 对象，或内部赋值错误导致对象无效。
8001	消息长度超出限制，消息长度不要超过12K，消息长度是各个 elem 长度的总和，elem 长度是所有 elem 字段的长度总和。
8002	消息 KEY 错误，内部错误，网络请求包的 KEY 和回复包的不一致。
8003	图片转换 HTTP 请求失败。
8004	万象优图因为鉴黄等原因转缩略图失败。
8005	合并转发消息嵌套层数超过上限100层。
8006	消息修改冲突，您请求修改的消息已经被其他人修改。
8010	信令请求 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人，音视频聊天室和在线成员广播大群无限制。
8508	不允许申请加入 Private 群组，任意群成员可邀请入群，且无需被邀请人同意。
8509	不允许邀请角色为群主的成员，请检查角色字段是否填写正确。
8510	不允许邀请0个成员，请检查成员字段是否填写正确。
8511	群属性接口操作限制：增删改接口后台限制1秒5次，查接口 SDK 限制5秒20次。
8512	获取群在线人数接口操作限制：查接口 SDK 限制60秒1次。
8513	获取群资料接口操作限制：查接口 SDK 限制1秒1次。
8514	获取加入群列表接口操作限制：查接口 SDK 限制1秒1次。
8515	不允许标记群成员。

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

错误码	描述
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	请求包已进入 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。
-10006	Key 中的账号和请求包头的账号不匹配。
-10007	验证码下发超时。
-10008	需要带上 Key 和 Ticket。
-10009	Cookie 检查不匹配。
-10106	解密失败次数超过阈值，通知终端需要重置，请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。
-10108	预付费欠费。
-10109	请求包格式错误。
-10110	SDKAppID 黑名单。
-10111	SDKAppID 设置 service cmd 黑名单。
-10112	SDKAppID 停用。
-10113	频率限制(用户)，频率限制是设置针对某一个协议的每秒请求数的限制。
-10114	过载丢包(系统)，连接的服务端处理过多请求，处理不过来，拒绝服务。
-20009	终端访问接口超频。

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

错误码	描述
60002	HTTP 解析错误，请检查 HTTP 请求 URL 格式。
60003	HTTP 请求 JSON 解析错误，请检查 JSON 格式。
60004	请求 URI 或 JSON 包体中 UserID 或 UserSig 错误。
60005	请求 URI 或 JSON 包体中 UserID 或 UserSig 错误。
60006	SDKAppID 失效，请核对 SDKAppID 有效性。
60007	REST 接口调用频率超过限制，请降低请求频率。
60008	服务请求超时或 HTTP 请求格式错误，请检查并重试。
60009	请求资源错误，请检查请求 URL。
60010	REST API 请求的 UserID 字段请填写 App 管理员账号。
60011	SDKAppID 请求频率超限，请降低请求频率。
60012	REST 接口需要带 SDKAppID，请检查请求 URL 中的 SDKAppID。
60013	HTTP 响应包 JSON 解析错误。
60014	置换账号超时。
60015	请求包体 UserID 类型错误，请确认 UserID 为字符串格式。
60016	SDKAppID 被禁用。
60017	请求被禁用。
60018	请求过于频繁，请稍后重试。
60019	请求过于频繁，请稍后重试。
60020	服务不可用。如未购买基础服务套餐包或套餐包过期失效，请购买基础服务套餐包；如腾讯云账号欠费，请充值结清欠款。
60021	RestAPI 调用来源 IP 非法。
60025	RestAPI 调用 SDKAppID、Identifier、UserSig 或 ContentType 错误，请检查 URL 参数。
60026	RestAPI 调用域名或 SDKAppID 与应用站不匹配。
80001	消息或者资料中文本存在敏感内容，禁止下发。
80002	发消息包体过长，目前支持最大12K消息包体长度，请减少包体大小重试。
80003	发单聊消息前回调或发群聊消息前回调失败或回包超时，消息不下发。可在控制台自助配置事件发生之前回调超时的处理策略。
80004	消息中图片存在敏感内容，禁止下发。

错误码	描述
70001	UserSig 已过期，请重新生成。建议 UserSig 有效期设置不小于24小时。
70002	UserSig 长度为0，请检查传入的 UserSig 是否正确。
70003	UserSig 非法，请使用官网提供的 API 重新生成 UserSig。
70005	UserSig 非法，请使用官网提供的 API 重新生成 UserSig。
70009	UserSig 验证失败，可能因为生成 UserSig 时混用了其他 SDKAppID 的私钥或密钥导致，请使用对应 SDKAppID 下的私钥或密钥重新生成 UserSig。
70013	请求中的 UserID 与生成 UserSig 时使用的 UserID 不匹配，您可以在即时通信 IM 控制台的【开发辅助工具】页面校验 UserSig。
70014	请求中的 SDKAppID 与生成 UserSig 时使用的 SDKAppID 不匹配，您可以在即时通信 IM 控制台的【开发辅助工具】页面校验 UserSig。
70016	公钥不存在，UserSig 验证失败，请在即时通信 IM 控制台获取密钥。
70020	SDKAppID 未找到，请在即时通信 IM 控制台确认应用信息。
70050	UserSig 验证次数过于频繁。请检查 UserSig 是否正确，并于1分钟后重新验证。您可以在即时通信 IM 控制台的【开发辅助工具】页面校验 UserSig。
70051	账号被拉入黑名单。
70107	请求的用户账号不存在。
70114	因安全原因被限制登录，请不要频繁登录。
70169	服务端内部超时，请稍后重试。
70202	服务端内部超时，请稍后重试。
70206	请求中批量数量不合法。
70402	参数非法，请检查必填字段是否填充，或者字段的填充是否满足协议要求。
70404	您使用的SDK版本太低，请升级到最新版本。
70403	请求失败，需要 App 管理员权限。
70398	账号数超限。如需创建多于100个账号，请将应用升级，具体操作指引请参见购买指引。
70500	服务端内部错误，请稍后重试。
71000	删除账号失败。仅支持删除体验版账号，您当前应用暂不支持账号删除。
72000	您当前应用为体验版，日活跃用户数（DAU）超过免费额度。若需解除该限制，请将应用升级为专业版或旗舰版，具体操作指引请参见购买指引。
72001	请在控制台开启用户状态查询及状态变更通知配置，具体操作指引请参见操作指引
72002	您当前应用为开发版，月活跃用户数（MAU）超过免费额度。若需解除该限制，请将应用升级为标准版或进阶版，具体操作指引请参见购买指引。
72010	单用户的登录、登出、切前台、切后台和设置离线推送配置信息请求超过频率限制。
72011	请在控制台 > 登录与消息开启全局消息免打扰相关的配置。
72012	请在控制台开启用户资料变更订阅配置，具体操作指引请参见操作指引。

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

错误码	描述
30001	请求参数错误，请根据错误描述检查请求是否正确。
30002	SDKAppID 不匹配。
30003	请求的用户账号不存在。
30004	请求需要 App 管理员权限。
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	网络超时，请稍后重试。
51006	修改会话标记时，调整的会话数为空或者超过了100个上限。
51007	GroupID 换 GroupCode 失败，内部错误或 Group 已经解散。
51008	会话分组的总的会话数超过了1000。
51009	删除会话分组时分组不存在。
51010	会话分组数超过了20个上限。
51011	会话分组名超过了32个字节。
51012	超过置顶会话数量上限。置顶会话数上限为50，不支持增加。

错误码	描述
20001	请求包非法。
20002	UserSig 或 A2 失效。
20003	消息发送方或接收方 UserID 无效或不存在，请检查 UserID 是否已导入即时通信 IM。
20004	网络异常，请重试。
20005	服务端内部错误，请重试。
20006	触发发送单聊消息之前回调，App 后台返回禁止下发该消息。
20007	发送单聊消息，被对方拉黑，禁止发送。消息发送状态默认展示为失败，您可以登录控制台修改该场景下的消息发送状态展示结果，具体操作请参见黑名单检查。
20008	消息发送方和接收方属于不同的 SDKAppID。原因是客户端切换了 SDKAppID，但数据库未进行清理。解决办法是在切换 SDKAppID 时删除原来的数据库。
20009	消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现）。
20010	发送单聊消息，自己不是对方的好友（单向关系），禁止发送。
20011	发送单聊消息，对方不是自己的好友（单向关系），禁止发送。
20012	发送方被禁言，该条消息被禁止发送。
20016	消息撤回超过了时间限制（默认2分钟）。
20018	删除漫游内部错误。
20022	该待撤回的消息不存在，请检查。
20023	该消息已被撤回。
20028	并发修改消息导致冲突，请重试。
21005	设置 token 请求比登录请求先到后台，请确保先登录，后设置 token。
22001	没有上传过任何离线推送证书。
22002	网络异常，请重试。
22003	上传的 token 为空。
22004	上传的 token 长度超过256字节。
22005	登录请求数据超过1024字节。
22006	请求超频。
90001	JSON 格式解析失败，请检查请求包是否符合 JSON 规范。
90002	JSON 格式请求包中 MsgBody 不符合消息格式描述，或者 MsgBody 不是 Array 类型，请参考 TIMMsgElement 对象的定义。
90003	JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 账号不存在。
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 或者是否拼写错误。
90018	请求的账号数量超过限制。
90022	推送条件中的 TagsOr 和 TagsAnd 有重复标签。
90024	推送过于频繁，每两次推送间隔必须大于1秒。
90026	消息离线存储时间错误（最多不能超过7天）。
90030	属性长度为0或大于50。
90031	JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型。
90032	推送条件中的 tag 数量大于10，或添加标签请求中的标签数量大于10。
90033	属性无效。
90034	标签长度大于50。
90040	推送条件中其中1个 tag 为空。
90043	JSON 格式请求包中 OfflinePushInfo 不符合消息格式描述，请参考 OfflinePushInfo 对象的定义。
90044	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	操作权限不足（例如 Public 群组中普通成员尝试执行踢人操作，但只有 App 管理员才有权限；或者非群成员操作）。
10009	该群不允许群主主动退出。
10010	群组不存在，或者曾经存在过，但是目前已经被解散。
10011	解析 JSON 包体失败，请检查包体的格式是否符合 JSON 格式。
10012	发起操作的 UserID 非法，请检查发起操作的用户 UserID 是否填写正确。
10013	用户已经是群成员。
10014	群已满员，无法将请求中的用户加入群组，如果是批量加人，可以尝试减少加入用户的数量。
10015	无效的群组 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）已配置不支持群消息撤回。
10044	表示该群类型不支持获取漫游，例如：AVChatRoom
10045	自定义属性 key 超过大小限制32字节。
10046	自定义属性单个 val 超过了大小限制4000字节。
10047	自定义属性 key 数量超过了限制16。
10048	自定义属性所有 key 对应的 val 大小之和超过上限16000字节。
10049	自定义属性写操作触发频控。
10050	删除不存在的自定义属性。
10051	消息删除超过最大范围限制。
10052	消息删除时候群里不存在消息。
10053	群@数量超过上限30。
10054	群成员过多，请分页拉取。
10056	自定义属性写操作竞争冲突，请获取最新的自定义属性后再进行写操作。
10058	表示体验版超过100个群的限制，需要购买套餐包提升建群数量限制。
10059	该特性需要购买进阶版才可以支持。
10060	群人数超过已读回执群上限。
10061	在线消息不支持已读回执。
10062	已读回执信息不存在。
10062	已读回执信息不存在。
10063	群计数器 Key 数量超过限制，最大为20个。
10070	置顶消息超出数量限制。
11000	未开通社群功能。

错误码	描述
-195	谷歌推送构建推送对象失败，通常是证书错误导致。
-196	参数缺失，选择了 intent，但是没有设置 intent 的值。
-197	证书错误，请检查证书相关参数排查。
-198	厂商响应错误。
-199	厂商网络异常。
-200	IM 后台网络错误。
-201	合法性检查没有通过，例如 token 或者证书 ID 错误。
-202	在推送给厂商之前，构建对象失败。
-203	华为日推送限制。

错误码	描述
1001	请求非法；请检查“请求 URL”是否正确。
1002	参数非法；请检查是否管理员账号，必填字段是否填充，或者字段的填充是否满足协议要求。
1003	系统错误。
1004	文件尚未生成，或者请求时段内没有消息。
1005	文件已过期。

错误码	描述
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 无效。