Enumeration V2TIMErrorCode

无错误。

执行中，请做好接口调用控制，例如，第一次初始化操作在回调前，后续的初始化操作会返回该错误码。

参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。

操作本地 IO 错误，检查是否有读写权限，磁盘是否已满。

错误的 JSON 格式，请检查参数是否符合接口的要求，具体可查看错误信息进一步定义哪个字段。

内存不足，可能存在内存泄漏，iOS 平台使用 Instrument 工具，Android 平台使用 Profiler 工具，分析出什么地方的内存占用高。

PB 解析失败，内部错误。

PB 序列化失败，内部错误。

IM SDK 未初始化，初始化成功回调之后重试。

加载本地数据库操作失败，可能存储文件有损坏。

本地数据库操作失败，可能是部分目录无权限或者数据库文件已损坏。

无 http 协议的访问权限，iOS 9.0 和 Android P 开始默认限制 http 协议，iOS 平台可配置 NSAppTransportSecurity 选项，Android 平台可配置 cleartextTrafficPermitted 选项，取消 http 协议的限制。

跨线程错误，不能在跨越不同线程中执行，内部错误。

TinyId 为空，内部错误。

Identifier 非法，必须不为空，要求可打印 ASCII 字符（0x20-0x7e），长度不超过32字节。

文件不存在，请检查文件路径是否正确。

文件大小超出了限制，语音、图片，最大限制是28MB，视频、文件，最大限制 100M

空文件，要求文件大小不是0字节，如果上传图片、语音、视频或文件，请检查文件是否正确生成。

文件打开失败，请检查文件是否存在，或者已被独占打开，引起 SDK 打开失败。

API 调用超频

正在执行时被终止，例如正在登录时，调用 unInit 停止使用 SDK 。

database 操作失败

database 查询的数据不存在

SDK 内部不应该出现的内部错误

套餐包不支持该接口的使用，请升级到旗舰版套餐

SDK 本地内容审核，命中敏感词

IM SDK 未登录，请先登录，成功回调之后重试，或者已被踢下线，可使用 TIMManager getLoginUser 检查当前是否在线。

自动登录时，并没有登录过该用户，这时候请调用 login 接口重新登录。

UserSig 过期，请重新获取有效的 UserSig 后再重新登录。

其他终端登录同一个账号，引起已登录的账号被踢，需重新登录。

登录正在执行中，例如，第一次 login 或 autoLogin 操作在回调前，后续的 login 或 autoLogin 操作会返回该错误码。

登出正在执行中，例如，第一次 logout 操作在回调前，后续的 logout 操作会返回该错误码。

TLS SDK 初始化失败，内部错误。

TLS SDK 未初始化，内部错误。

TLS SDK TRANS 包格式错误，内部错误。

TLS SDK 解密失败，内部错误。

TLS SDK 请求失败，内部错误。

TLS SDK 请求超时，内部错误。

会话无效，getConversation 时检查是否已经登录，如未登录获取会话，会有此错误码返回。

文件传输鉴权失败。

文件传输获取 Server 列表失败。

文件传输上传失败，请检查网络是否连接。

文件传输上传失败，请检查上传的图片是否能够正常打开。

文件传输下载失败，请检查网络，或者文件、语音是否已经过期，目前资源文件存储7天。

HTTP 请求失败，请检查 URL 地址是否合法，可在网页浏览器尝试访问该 URL 地址。

IM SDK 无效消息 elem，具体可查看错误信息进一步定义哪个字段。

无效的对象，例如用户自己生成 TIMImage 对象，或内部赋值错误导致对象无效。

无效的消息接收方，请在 IM 控制台检查消息的接收方是否存在。

消息长度超出限制，消息长度不要超过12k，消息长度是各个 elem 长度的总和，elem 长度是所有 elem 字段的长度总和。

消息 KEY 错误，内部错误，网络请求包的 KEY 和 回复包的不一致。

万象优图 HTTP 请求失败。

万象优图因为鉴黄等原因转缩略图失败。

合并消息嵌套层数超过上限（上限 100 层）。

消息修改冲突，您请求修改的消息已经被其他人修改。

信令请求 ID 无效或已经被处理过。（上层接口使用，底层为了不重复也增加一份）

信令请求无权限，比如取消非自己发起的邀请。（上层接口使用，底层为了不重复也增加一份）

信令邀请已存在。

取消消息时，取消的消息不存在，或者已经发送成功。取消失败

消息发送失败，因为该消息已被取消

群组 ID 非法，自定义群组 ID 必须为可打印 ASCII 字符（0x20-0x7e），最长48个字节，且前缀不能为 @TGS#（避免与服务端默认分配的群组 ID 混淆）。

群名称非法，群名称最长30字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

群简介非法，群简介最长240字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

群公告非法，群公告最长300字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

群头像 URL 非法，群头像 URL 最长100字节，可在网页浏览器尝试访问该 URL 地址。

群名片非法，群名片最长50字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

超过群组成员数的限制，在创建群和邀请成员时，指定的成员数超出限制，最大群成员数量：私有群是200人，公开群是2000人，聊天室是10000人，音视频聊天室和在线成员广播大群无限制。

不允许申请加入 Private 群组，任意群成员可邀请入群，且无需被邀请人同意。

不允许邀请角色为群主的成员，请检查角色字段是否填写正确。

不允许邀请0个成员，请检查成员字段是否填写正确。

群属性接口操作限制：增删改接口后台限制1秒5次，查接口 SDK 限制5秒20次。

获取群在线人数接口操作限制：查接口 SDK 限制60秒1次。

获取群资料接口操作限制：查接口 SDK 限制1秒1次。

获取加入群列表接口操作限制：查接口 SDK 限制1秒1次。

资料字段非法，资料支持标配字段及自定义字段，其中自定义字段的关键字，必须是英文字母，且长度不得超过8字节，自定义字段的值最长不能超过500字节。

备注字段非法，最大96字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

请求添加好友的请求说明字段非法，最大120字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

请求添加好友的添加来源字段非法，来源需要添加“AddSource_Type_”前缀。

好友分组字段非法，必须不为空，每个分组的名称最长30字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。

超过数量限制

网络加密失败，内部错误。

网络数据解密失败，内部错误。

未完成鉴权，可能登录未完成，请在登录完成后再操作。

数据包压缩失败，内部错误。

数据包解压失败，内部错误。

调用频率限制，最大每秒发起 5 次请求。

请求队列満，超过同时请求的数量限制，最大同时发起1000个请求。

网络已断开，未建立连接，或者建立 socket 连接时，检测到无网络。

网络连接已建立，重复创建连接，内部错误。

建立网络连接超时，请等网络恢复后重试。

网络连接已被拒绝，请求过于频繁，服务端拒绝服务。

没有到达网络的可用路由，请等网络恢复后重试。

系统中没有足够的缓冲区空间资源可用来完成调用，系统过于繁忙，内部错误。

对端重置了连接，可能服务端过载，SDK 内部会自动重连，请等网络连接成功 onConnSucc （ iOS ） 或 onConnected （ Android ） 回调后重试。

socket 套接字无效，内部错误。

IP 地址解析失败，内部错误，可能是本地 imsdk_config 配置文件被损坏，读取到到 IP 地址非法。

网络连接到中间节点或服务端重置，引起连接失效，内部错误，SDK 内部会自动重连，请等网络连接成功 onConnSucc （ iOS ） 或 onConnected （ Android ） 回调后重试。

请求包等待进入待发送队列超时，发送时网络连接建立比较慢 或 频繁断网重连时，会出现该错误，请检查网络连接是否正常。

请求包已进入 IM SDK 待发送队列，等待进入操作系统的网络层时超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。

请求包已由 IM SDK 待发送队列进入操作系统网络层，等待服务端回包超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。

请求包已进入待发送队列，部分数据已发送，等待发送剩余部分出现超时，可能上行带宽不足，请检查网络是否畅通，在回调错误时检测有联网，内部错误。

请求包长度大于限制，最大支持 1MB 。

请求包已进入待发送队列，等待进入系统的网络 buffer 超时，数据包较多 或 发送线程处理不过来，在回调错误码时检测到没有联网。

请求包已进入系统的网络 buffer ，等待服务端回包超时，可能请求包没离开终端设备、中间路由丢弃、服务端意外丢包或回包被系统网络层丢弃，在回调错误码时检测到没有联网。

请求包已进入待发送队列，部分数据已发送，等待发送剩余部分出现超时，可能上行带宽不足，请检查网络是否畅通，在回调错误码时检测到没有联网。

Server 的连接数量超出限制，服务端拒绝服务。

下发验证码标志错误。

Key 过期。Key 是根据 UserSig 生成的内部票据，Key 的有效期小于或等于 UserSig 的有效期。请重新调用 V2TIMManager.getInstance().login 登录接口生成新的 Key。

Ticket 过期。Ticket 是根据 UserSig 生成的内部票据，Ticket 的有效期小于或等于 UserSig 的有效期。请重新调用 V2TIMManager.getInstance().login 登录接口生成新的 Ticket。

票据验证没通过或者被安全打击。请重新调用 V2TIMManager.getInstance().login 登录接口生成新的票据。

不允许空 Key。

Key 中的账号和请求包头的账号不匹配。

验证码下发超时。

需要带上 Key 和 Ticket。

Cookie 检查不匹配。

下发提示语时 Key 过期。Key 是根据 UserSig 生成的内部票据，Key 的有效期小于或等于 UserSig 的有效期。请重新调用 V2TIMManager.getInstance().login 登录接口生成新的 Key。

网络连接断开。

失效身份。

终端自动退出。

MSFSDK 自动退出。

解密失败次数超过阈值，通知终端需要重置，请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。

不支持聚合，给终端返回统一的错误码。终端在该 TCP 长连接上停止聚合。

预付费欠费。

请求包格式错误。

SDKAppID 黑名单。

SDKAppID 设置 service cmd 黑名单。

SDKAppID 停用。

频率限制(用户)，频率限制是设置针对某一个协议的每秒请求数的限制。

过载丢包(系统)，连接的服务端处理过多请求，处理不过来，拒绝服务。

终端访问接口超频。

要发送的资源文件不存在。

要发送的资源文件不允许访问。

文件大小超过限制。

用户取消发送，如发送过程中登出等原因。

读取文件内容失败。

资源文件（如图片、文件、语音、视频）传输超时，一般是网络问题导致。

参数非法。

文件 MD5 校验失败。

分片 MD5 校验失败。

HTTP 解析错误 ，请检查 HTTP 请求 URL 格式。

HTTP 请求 JSON 解析错误，请检查 JSON 格式。

请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。

请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。

SDKAppID 失效，请核对 SDKAppID 有效性。

REST 接口调用频率超过限制，请降低请求频率。

服务请求超时或 HTTP 请求格式错误，请检查并重试。

请求资源错误，请检查请求 URL。

REST API 请求的 Identifier 字段请填写 App 管理员账号。

SDKAppID 请求频率超限，请降低请求频率。

REST 接口需要带 SDKAppID，请检查请求 URL 中的 SDKAppID。

HTTP 响应包 JSON 解析错误。

置换账号超时。

请求包体 Identifier 类型错误，请确认 Identifier 为字符串格式。

SDKAppID 被禁用。

请求被禁用。

请求过于频繁，请稍后重试。

请求过于频繁，请稍后重试。

未购买套餐包或购买的套餐包正在配置中暂未生效，请五分钟后再次尝试。

文本安全打击，文本中可能包含敏感词汇。

发消息包体过长，目前支持最大12k消息包体长度，请减少包体大小重试。

图片安全打击，图片中可能包含敏感内容。

UserSig 已过期，请重新生成 UserSig，建议 UserSig 有效期不小于24小时。

UserSig 长度为0，请检查传入的 UserSig 是否正确。

UserSig 校验失败，请确认下 UserSig 内容是否被截断，如缓冲区长度不够导致的内容截断。

UserSig 校验失败，可用工具自行验证生成的 UserSig 是否正确。

用公钥验证 UserSig 失败，请确认生成的 UserSig 使用的私钥和 SDKAppID 是否对应。

请求的 Identifier 与生成 UserSig 的 Identifier 不匹配。

请求的 SDKAppID 与生成 UserSig 的 SDKAppID 不匹配。

验证 UserSig 时公钥不存在。请先登录控制台下载私钥，下载私钥的具体方法可参考 下载签名用的私钥 。

SDKAppID 未找到，请在云通信 IM 控制台确认应用信息。

UserSig 已经失效，请重新生成，再次尝试。

请求的用户账号不存在。

安全原因被限制。

服务端内部超时，请重试。

请求中批量数量不合法。

参数非法，请检查必填字段是否填充，或者字段的填充是否满足协议要求。

请求需要 App 管理员权限。

您的SDK版本过低，请升级到最新版本.

因失败且重试次数过多导致被限制，请检查 UserSig 是否正确，一分钟之后再试。

账号被拉入黑名单。

创建账号数量超过免费体验版数量限制，请升级为专业版。

服务端内部错误，请重试。

用户状态能力需要登录 IM 控制台开启

请求参数错误，请根据错误描述检查请求是否正确。

请求参数错误，没有指定需要拉取资料的用户账号。

请求的用户账号不存在。

请求需要 App 管理员权限。

资料字段中包含敏感词。

服务端内部错误，请稍后重试。

没有资料字段的读权限，详情可参见 资料字段 。

没有资料字段的写权限，详情可参见 资料字段 。

资料字段的 Tag 不存在。

资料字段的 Value 长度超过500字节。

标配资料字段的 Value 错误，详情可参见 标配资料字段 。

资料字段的 Value 类型不匹配，详情可参见 标配资料字段 。

用户资料变更订阅能力未开启，请参见 订阅非好友用户资料， 登录 IM 控制台 开启该功能

请求参数错误，请根据错误描述检查请求是否正确。

SDKAppID 不匹配。

请求的用户账号不存在。

请求需要 App 管理员权限。

关系链字段中包含敏感词。

服务端内部错误，请重试。

网络超时，请稍后重试。

并发写导致写冲突，建议使用批量方式。

后台禁止该用户发起加好友请求。

自己的好友数已达系统上限。

分组已达系统上限。

未决数已达系统上限。

黑名单数已达系统上限。

对方的好友数已达系统上限。

已经存在好友关系。

请求添加好友时，对方在自己的黑名单中，不允许加好友。

请求添加好友时，对方的加好友验证方式是不允许任何人添加自己为好友。

请求添加好友时，自己在对方的黑名单中，不允许加好友。

A 请求加 B 为好友，B 的加好友验证方式被设置为“AllowType_Type_NeedConfirm”，这时 A 与 B 之间只能形成未决关系，该返回码用于标识加未决成功，以便与加好友成功的返回码区分开，调用方可以捕捉该错误给用户一个合理的提示。

添加好友请求被安全策略打击，请勿频繁发起添加好友请求。

请求的未决不存在。

与请求删除的账号之间不存在好友关系。

删除好友请求被安全策略打击，请勿频繁发起删除好友请求。

请求的用户账号不存在。

自己的关注数量到达上限

对方的粉丝数量到达上限。

自己的互关数量到达上限。

对方的互关数量到达上限。

请求的用户账号不存在。

请求参数错误，请根据错误描述检查请求是否正确。

请求需要 App 管理员权限。

服务端内部错误，请重试。

网络超时，请稍后重试。

一次标记、分组、设置自定义数据的会话数超过了上限（最大支持 100 个）

Group 会话操作异常，Server 内部错误或 Group 已经解散

标记、分组、设置自定义数据的总会话数超过了上限（最大支持 1000 个）

会话分组不存在

会话分组数超过了上限（最大支持 20 个）

会话分组名字节数超过了上限（最大支持 32 字节）

请求包非法，请检查发送方和接收方账号是否存在。

内部鉴权失败。

Identifier 无效或者 Identifier 未导入云通信 IM。

网络异常，请重试。

服务端内部错误，请重试。

触发发送单聊消息之前回调，App 后台返回禁止下发该消息。

发送单聊消息，被对方拉黑，禁止发送。

消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现）。

发送单聊消息，自己不是对方的好友（单向关系），禁止发送。

发送单聊消息，对方不是自己的好友（单向关系），禁止发送。

因禁言，禁止发送消息。

消息撤回超过了时间限制（默认2分钟）。

删除漫游内部错误。

消息扩展操作冲突。

删除的消息扩展不存在。

单条消息 Reaction 数量超过最大限制。

单个 Reaction 用户数量超过最大限制。

Reaction 已经包含当前操作用户。

Reaction 不存在。

Reaction 不包含当前操作用户。

JSON 格式解析失败，请检查请求包是否符合 JSON 规范。

JSON 格式请求包中 MsgBody 不符合消息格式描述，或者 MsgBody 不是 Array 类型，请参考 TIMMsgElement 对象 的定义。

JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 字段不是 Integer 类型

JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型

JSON 格式请求包体中缺少 MsgTimeStamp 字段或者 MsgTimeStamp 字段不是 Integer 类型

JSON 格式请求包体中 MsgBody 类型不是 Array 类型，请将其修改为 Array 类型

请求需要 App 管理员权限。

JSON 格式请求包不符合消息格式描述，请参考 TIMMsgElement 对象 的定义。

批量发消息目标账号超过500，请减少 To_Account 中目标账号数量。

To_Account 没有注册或不存在，请确认 To_Account 是否导入云通信 IM 或者是否拼写错误。

消息离线存储时间错误（最多不能超过7天）。

JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型

JSON 格式请求包体中 MsgLifeTime 字段不是 Integer 类型

请求的用户账号不存在。

服务内部错误，请重试。

服务内部错误，请重试。

服务内部错误，请重试。

服务内部错误，请重试；如果所有请求都返回该错误码，且 App 配置了第三方回调，请检查 App 服务端是否正常向云通信 IM 后台服务端返回回调结果。

JSON 数据包超长，消息包体请不要超过12k。

Web 端长轮询被踢（Web 端同时在线实例个数超出限制）。

服务端内部错误，请重试。

请求中的接口名称错误，请核对接口名称并重试。

参数非法，请根据错误描述检查请求是否正确。

请求包体中携带的账号数量过多。

操作频率限制，请尝试降低调用的频率。

操作权限不足，比如 Public 群组中普通成员尝试执行踢人操作，但只有 App 管理员才有权限。

请求非法，可能是请求中携带的签名信息验证不正确，请再次尝试。

该群不允许群主主动退出。

群组不存在，或者曾经存在过，但是目前已经被解散。

解析 JSON 包体失败，请检查包体的格式是否符合 JSON 格式。

发起操作的 Identifier 非法，请检查发起操作的用户 Identifier 是否填写正确。

被邀请加入的用户已经是群成员。

群已满员，无法将请求中的用户加入群组，如果是批量加人，可以尝试减少加入用户的数量。

群组 ID 非法，请检查群组 ID 是否填写正确。

App 后台通过第三方回调拒绝本次操作。

因被禁言而不能发送消息，请检查发送者是否被设置禁言。

应答包长度超过最大包长（1MB），请求的内容过多，请尝试减少单次请求的数据量。

请求的用户账号不存在。

群组 ID 已被使用，请选择其他的群组 ID。

发消息的频率超限，请延长两次发消息时间的间隔。

此邀请或者申请请求已经被处理。

群组 ID 已被使用，并且操作者为群主，可以直接使用。

该 SDKAppID 请求的命令字已被禁用。

请求撤回的消息不存在。

消息撤回超过了时间限制（默认2分钟）。

请求撤回的消息不支持撤回操作。

群组类型不支持消息撤回操作。

该消息类型不支持删除操作。

音视频聊天室和在线成员广播大群不支持删除消息。

音视频聊天室创建数量超过了限制，请参考 价格说明 购买预付费套餐“IM音视频聊天室”。

单个用户可创建和加入的群组数量超过了限制，请参考 价格说明 购买或升级预付费套餐“单人可创建与加入群组数”。

群成员数量超过限制，请参考 价格说明 购买或升级预付费套餐“扩展群人数上限”。

置顶消息超出数量限制时。