跳到主要内容

状态码

SDK 状态码​

状态码说明排查建议
-4应用没有调用 connect() 方法，即调用业务。
-3参数异常, 请确认参数是否填写正确且有效。
-2IPC 进程意外终止。当 libRongIMLib.so 或 libsqlite.so 找不到或出现崩溃时也会触发此错误。如果是系统进行了资源回收后调用接口会触发此问题，SDK 会做好自动重连。
-1未知错误。
0连接成功。
405已被对方加入黑名单，消息发送失败。
407未在对方的白名单中，消息发送失败。
20106该用户处于单聊禁言状态，禁止发送单聊消息。
20604发送消息频率过高，1 秒钟最多只允许发送 5 条消息，详细请联系商务，电话：13161856839。
20605信令被封禁。如遇到该错误，请提交工单。
20607调用超过频率限制，请稍后再试。
22201消息扩展/修改，但是原始消息不存在。
22202消息扩展/修改，但是原始消息不支持扩展。
22203消息扩展/修改，扩展内容格式错误。
22204消息扩展/修改，无操作权限。
22406当前用户不在群组中。
22408当前用户在群组中已被禁言。
23406当前用户不在聊天室中，请加入聊天室再调用和聊天室相关方法。
23408当前用户在该聊天室中已被禁言。
23409当前用户已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。
23410聊天室不存在。
23411聊天室成员超限，开发者可以提交工单申请聊天室人数限制变更。
23412聊天室接口参数不正确。
23414聊天室云存储业务未开通。
23423聊天室的属性个数超限，单个聊天室默认上限为 100 个。
23424没有权限修改聊天室中已存在的属性值。
23425聊天室中属性设置频率超限，单个聊天室每秒上限 100 次。
23426未开通聊天室属性自定义设置。请在控制台免费基础功能页面开通聊天室属性自定义设置。
23427聊天室属性不存在。
23431多端操作聊天室同一属性时属性设置失败。
24401超级群功能没有开通。
24402超级群服务异常。
24403超级群参数错误。
24404超级群未知异常。
24406当前用户不在超级群中。
24408当前用户在超级群中已被禁言。
24410超级群不存在。
24411超级群成员超限制。
24412用户加入超级群数量超限。
24413创建超级群频道，频道数超限。
24414超级群频道 ID 不存在。
24416用户不在超级群私有频道成员列表中
25101撤回参数不正确。
25102未开通历史消息云存储。请开通单群聊消息云端存储或聊天室消息云端存储服务。
25103清除历史消息时，传递的时间戳大于当前系统时间。
25105清除历史消息时遇到内部异常，请提交工单确认原因。
25107撤回他人消息失败。服务端可控制消息是否可由他人（非发送者本人）撤回。如果服务端已设置为仅限发送者本人撤回，则在撤回他人消息时报这个错误。
26001Push 参数不正确。
26002向服务端同步时出现问题，有可能是操作过于频繁所致。请稍后再试。
30001连接已被释放,连接相关的错误码，SDK 会做好自动重连，开发者无须处理。
30002连接不可用, 连接相关的错误码，SDK 会做好自动重连，开发者无须处理。
30003客户端发送消息请求，融云服务端响应超时。
30004导航 HTTP 发送失败。
30005请求连接导航地址失败。
30006请求连接导航地址后，接收数据失败。
30007导航 HTTP 请求失败。
30008导航 HTTP 返回数据格式错误。
30009导航数据解析后，其中不存在有效 IP 地址。
30010创建 Socket 连接失败,连接相关的错误码，SDK 会做好自动重连，开发者无须处理。
30011Socket 断开。
30012PING 失败。
30013PING 超时。
30014信令发送失败。
30015连接过于频繁。
30016消息大小超限，消息体最大 128 KB。
31000连接ACK超时。
31002初始化时填写的 AppKey 不正确，请在控制台获取。
31004Token 无效。
31005App 校验未通过（开通了 App 校验功能，但是校验未通过）
31006连接重定向。连接相关的错误码，SDK 会做好自动重连，开发者无须处理。
31007ApplicationId 与后台注册信息不一致。
31008AppKey 被封禁或已删除。
31009连接失败，一般因为用户已被封禁。
31010当前用户在其他移动设备上登录，此设备被踢下线。
31011用户在线时被封禁导致连接断开。
31020Token过期。一般是因为在控制台设置了token 过期时间，需要请求您的服务器重新获取 token 并再次用新的 token 建立连接。
31023重连过程中当前用户在其它移动设备上登录。
31028配置了 SDK 通过代理连接融云，但代理地址不可用。
32061连接被拒绝. SDK 会自动重连，开发者无须处理。
32054TCP 连接被重置，可能原因是运营商认为此链接非法或无效。SDK 会自动触发重连，App 侧无需处理。
33000将消息存储到本地数据时失败。发送或插入消息时，消息需要存储到本地数据库，当存库失败时，会回调此错误码。
33001未调用 SDK 的初始化（init）方法。
33002数据库错误。
33003调用接口时传入的参数不正确。
33007未开通历史消息云存储服务，参见控制台文档开通单群聊历史消息云存储服务
34001连接已存在，或正在重连中。
34002小视频时间长度超出限制.默认小视频时长上限为 2 分钟。
34003GIF 消息文件大小超出限制.默认 GIF 文件大小上限是 2 MB。
34004聊天室状态未同步完成，加入聊天室时立即调用获取聊天室属性接口，极限情况下会存在本地数据和服务器未同步完成的情况。您可以设置聊天室属性回调，SDK 同步完成时会在属性回调中通知，您可根据回调状态进行获取。
34005连接环境不正确。
34006连接超时。
34007查询的公共服务信息不存在。
34008消息不能被扩展。消息在发送时，Message 对象的属性 canIncludeExpansion 置为 true 才能进行扩展。
34009消息扩展失败。一般是网络原因导致的，请确保网络状态良好，并且融云 SDK 连接正常。
34010消息扩展大小超出限制， 默认消息扩展字典 key 长度不超过 32 个字符，value 长度不超过 4096 个字符（ SDK < 5.2.0 时，value 长度限制最大 64 个字符），设置的 Expansion 键值对不超过 300 个。
34021消息未注册。发送或者插入自定义消息之前，请确保注册了该类型的消息。
34022该接口不支持超级群会话。
34023超级群功能未开通。
34024超级群频道不存在。
34004聊天室状态未同步完成，加入聊天室时立即调用获取聊天室属性接口，极限情况下会存在本地数据和服务器未同步完成的情况，开发者可以设置聊天室属性回调，SDK 同步完成时会在属性回调中通知开发者，开发者可根据回调状态进行获取。
34005连接环境不正确。2.10.4 公有云 SDK 将不再支持连接私有云. 私有云要使用新版 SDK 可联系商务。
34209传入的 ConversationType 非法。
34210传入的 targetId 非法。
34211传入的 channelId 非法。
34212传入的 tagId 非法。
34213传入的 tagName 非法。
34214传入的 userId 非法。
34215传入的 userIdList 非法。
34238非法的代理配置。请检查代理是否为空或者是否传入了非法参数。
34239传入的代理测试服务非法。
34240代理地址或 testHost 地址无法连通。
34241超级群撤回了不支持的消息类型，请开发者判断当前 MessageContent 类型是否支持被撤回。
40006RTC 房间操作时传入参数错误。
24360没有设置该用户托管属性的权限。
24361用户托管基本属性的 key 列表中没有此 key。
24362用户托管扩展属性的 key 列表中没有此 key。
24363超过了可以设置的用户托管扩展属性的最大上限。
24364用户托管基本属性或扩展属性的 Value 字符超过最大上限。
24365批量查询用户托管资料的数量超过了可以查询的上限 100 个。
24366没有此用户。
24367用户托管此属性 Value 只能是数字。
24368用户托管此属性 Value 值超过设置取值范围。
24369未开启用户信息托管功能。
25402托管服务异常。
25403托管服务参数错误。
25404非法操作，非群主修改群权限相关。
25405没有权限操作调用的功能。
25406参数异常，存在长度超限。
25407参数异常，非法字符。
25408参数值必须是数字。
25409群组 ID 已存在。
25410群 ID 不存在。
25411群成员超限。
25412群成员 ID 已在当前群组中。
25413不允许通过 SDK 进行此操作。
25414不允许任何人加入，无法加入群组。
25415扩展信息 Key 值不存在。
25416查询频率超限。
25417群主不能被踢出/退出群组。
25418用户 ID 不在群组中。
25419管理员/关注人数超过上限。
25420用户 ID 不在当前群管理员。
25421无对应群 ID 和用户 ID 的邀请请求。
25422查询群信息个数超限。
25423群名称不能为空。
25424申请进群需要等待管理员审批。
25425群主不支持设置为管理员。
25426邀请人进群时没有权限。
25427邀请进群需要被邀请人同意。
25428管理员或群主处理请求时，别的管理员已处理。
25429老的群不支持调用托管接口，需要导入后才能调用。
25430群 ID 不合法，包含特殊字符。
25432pagetoken 解析失败。
25460已经互为好友，操作无效。
25461待对方同意后才能加为好友。
25462在目标用户黑名单中，不能添加好友。
25463不在目标用户白名单中，不能添加好友。
25464目标用户在当前用户黑名单中，不能添加好友。
25465不在当前用户白名单中，不能添加好友。
25466操作无效，该好友请求不存在或已经过期。
25467当前用户好友数超出上限。
25468目标用户好友数超出上限。
25469非好友关系，不能执行此操作。
25470好友自定义属性超出上限。
25471对方设置了不允许加为好友。
25472好友不存在。
25473不能添加自己为好友。
26020未开启在线状态订阅功能。
26021用户被订阅量达到上限，详细查看开发文档。
26022订阅用户数达到上限，详细查看开发文档。
34306订阅相关接口传入的订阅类型不支持。
34307订阅相关接口传入的订阅时长非法。
34308订阅相关接口传入的订阅用户列表非法。
34309订阅相关接口传入的分页大小非法。
34312参数 userProfile 非法。
34313参数 userProfileVisibility 非法。
34314参数 extra 无效。
34315数据库升级失败。
34318开发者接口调用时传入的参数 GroupInfo 非法。
34319开发者接口调用时传入的参数 groupId 非法。
34320开发者接口调用时传入的参数 groupName 非法。
34321开发者接口调用时传入的参数 groupIds 非法。
34322开发者接口调用时传入的参数 GroupMemberRole 非法。
34323开发者接口调用时传入的参数 GroupApplicationStatus 非法。
34324开发者接口调用时传入的参数 GroupApplicationDirection 非法。
34325开发者接口调用时传入的参数 nickname 非法。
34326开发者接口调用时传入的参数 reason 非法。
34327开发者接口调用时传入的参数 remark 非法。
34328开发者接口调用时传入的参数 PagingQueryOption 非法。
34329数据正在同步中。
34330开发者接口调用时传入的参数 QueryFriendsDirectionType 非法。
34331开发者接口调用时传入的参数 DirectionType 非法。
34332开发者接口调用时传入的参数 FriendApplicationType 非法。
34333开发者接口调用时传入的参数 FriendApplicationStatus 非法。
34334开发者接口调用时传入的参数 FriendAddPermission 非法。
34335开发者接口调用时传入的参数 extProfile 非法。
编辑此页
最后由 Gordon Zhu 于 更新