状态码

本文档列出了 RongIMLib 的所有状态码，内容基于枚举 ErrorCode。

连接状态码

App 可以监听 SDK 连接状态。在连接中可能抛出以下状态码。

提示

• 5.6.1 版本之前，事件 Events.DISCONNECT 与 Events.SUSPEND 回调函数中的 code 类型为 ConnectionStatus。
• 5.7.0 版本之后，事件 Events.DISCONNECT 与 Events.SUSPEND 回调函数中的 code 类型为 ErrorCode。

ConnectionStatus 中提供以下连接状态：

状态码	说明
0	连接成功
1	正在连接中
2	用户主动断开连接
3	网络不可用，SDK 内部会自动重连
4	Socket 不可用, SDK 内部会自动重连
6	被其他端踢掉
9	用户被封禁
12	域名错误

业务错误码

-1

TIMEOUT

未知错误。

排查建议： 接口请求超时，请稍后重试。若重试多次，仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

0

SUCCESS

成功。

排查建议：接口请求成功。

2

ACTIVE_DISCONNECT

主动断开连接。

排查建议：业务层主动调用 disconnect 断开连接。

405

REJECTED_BY_BLACKLIST

已被对方加入黑名单，消息发送失败。

排查建议：可根据业务需求将用户移出黑名单，请参阅移除黑名单中用户。

20106

FORBIDDEN_IN_PRIVATE

在单聊中已被禁言。

排查建议：可根据业务需求取消用户禁言，详情请参阅设置用户单聊禁言。

20109

SYS_CONVERSATION_NOT_SUPPORT_MESSAGE

系统会话不支持发送该消息类型。

排查建议：系统会话只允许发送 RC:SRSMsg 类型消息，其它消息类型暂不支持发送。

20512

CLOUD_DATA_CENTER_INVALID

appkey 的数据中心与请求云控的数据中心不匹配。

排查建议：

1. 当您选择了国内数据中心，App 服务端集成融云服务端 API 时，必须使用国内的 API 地址。客户端集成默认连接国内数据中心。
2. 当您选择了海外的数据中心，如新加坡、北美、或沙特，App 服务端集成融云服务端 API 时，必须使用相对应的API 海外地址。
3. 您可以在融云控制台 > 应用配置 > 基本信息 > AppKey 配置页面查看您应用属于哪个数据中心。
4. 集成客户端时，您须传入相对应的区域码，或者手动设置 SDK 连接的服务器的地址。

20604

SEND_FREQUENCY_TOO_FAST

发送消息频率过高，1 秒钟最多只允许发送 5 条消息。

排查建议：建议客户端延时调用接口，防止超频导致报错。

20606

OPERATION_NOT_SUPPORT

操作不支持，仅私有云有效，服务端禁用了该操作。

排查建议：只适用于私有云环境，公有云用户可忽略。

20607

REQUEST_OVER_FREQUENCY

请求超出了调用频率限制，请稍后再试。

排查建议：调用查询类信令超限，默认限制为 50 次/秒，请将客户端调用接口的频率控制在 50 次/秒范围内。

22201

MESSAGE_EXPAND_NOT_EXIST

超级群扩展消息，但是原始消息不存在。

排查建议：

1. 超级群历史消息默认存储 7 天，超过 7 天的消息会被删除，可根据消息的 sentTime 判断是否为 7 天前的消息。
2. 原消息可能已经被手动删除，可通过获取超级群会话历史消息确认原消息是否存在。

22202

MESSAGE_EXPAND_NOT_SUPPORT

超级群扩展消息，但是原始消息不支持扩展。

排查建议：发送消息将 canIncludeExpansion 设置为 true 后，该消息才支持扩展，详情请参阅收发消息文档。

22203

MESSAGE_EXPAND_FORMAT_ERROR

超级群扩展消息，扩展内容格式错误。

排查建议：设置的扩展内容服务端解析失败，扩展内容必须为 JSON 字符串格式，例如：{"key":"value"}。

22204

MESSAGE_EXPAND_NOT_AUTHORIZED

超级群扩展消息，无操作权限。

排查建议：传入的会话类型参数错误，请检查传入的会话类型值是否为 10。

22406

NOT_IN_GROUP

不在该群组中。

排查建议：

1. 请检查用户是否在群组中，可通过融云控制台 > 北极星 > Server Api 调试群组模块进行查询，加入等动作。
2. 如果用户在群组中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，群组ID，问题发生时间等。

22408

FORBIDDEN_IN_GROUP

在群组中已被禁言。

排查建议：业务层可按需取消群组/超级群禁言，详情请参阅群组禁言服务/超级群禁言服务。

23406

NOT_IN_CHATROOM

不在该聊天室中。

排查建议：

1. 可通过融云控制台 > 北极星 > Server Api 调试聊天室模块进行查询，加入等动作。
2. 聊天室具有自动销毁机制和离线成员自动退出机制，触发上述机制也会导致用户不在聊天室中，您可以在聊天室状态同步中获取到详细信息。
3. 如果用户在聊天室中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，聊天室ID，问题发生时间等。

23407

GET_USERINFO_ERROR

聊天室禁言白名单人数超限。

排查建议：有两种情况会返回该错误码

1. 加入聊天室用户白名单，传入 userId 超限（最多 5 个），接口详情请参阅加入聊天室用户白名单
2. 加入聊天室全体禁言白名单，传入 userId 超限（最多 20 个），接口详情请参阅加入聊天室全体禁言白名单

23408

FORBIDDEN_IN_CHATROOM

在该聊天室中已被禁言。

排查建议：

1. 禁言状态分为：设置聊天室全体禁言，全局禁言用户，禁言指定聊天室用户
2. 业务层可按需根据上述禁言状态取消聊天室全体禁言，取消全局禁言用户，取消禁言指定聊天室用户

23409

RC_CHATROOM_USER_KICKED

已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。

排查建议：业务层可按需解除封禁，详情请参阅解除封禁聊天室用户

23410

RC_CHATROOM_NOT_EXIST

聊天室不存在。

排查建议：

1. 聊天室具有自动销毁机制和离线成员自动退出机制，详情请参阅聊天室销毁机制和退出聊天室文档，业务层可观察一下是否因为上述机制导致。
2. 也可通过融云控制台 > 北极星 > Server Api 调试聊天室模块进行查询，创建等动作。

23411

RC_CHATROOM_IS_FULL

聊天室成员超限，开发者可以提交工单申请聊天室人数限制变更。

排查建议：

1. 聊天室业务默认成员无上限，但也可配置上限，请先确认是否配置过聊天室成员上限。
2. 如需调整聊天室成员上限，请提交工单与我们联系。

23412

RC_CHATROOM_PATAMETER_INVALID

聊天室接口参数无效。请确认参数是否为空或者有效。

排查建议：

1. 请根据接口文档检查参数是否为空或者有效。
2. 检查参数后仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如接口名称，接口参数，问题发生时间等。

23413

CHATROOM_GET_HISTORYMSG_ERROR

查询聊天室历史消息异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，聊天室ID，查询时间等。

23414

CHATROOM_NOT_OPEN_HISTORYMSG_STORE

聊天室云存储业务未开通。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > IM 服务管理开通聊天室消息云端存储服务。

23423

CHATROOM_KV_EXCEED

聊天室的 KV 属性个数超限。

排查建议：单个聊天室默认上限为 100 个

23424

CHATROOM_KV_OVERWRITE_INVALID

没有权限修改聊天室中已存在的属性值。

排查建议：业务层没有权限修改其他人设置的 KV 属性值，如果要设置需要调用强制设置接口，详情请参阅聊天室属性管理(KV)文档。

23425

CHATROOM_SET_PROPERTY_OVER_FREQUENCY

【已废弃】超过聊天室中状态设置频率，1 个聊天室 1 秒钟最多设置和删除状态 100 次。

23426

CHATROOM_KV_STORE_NOT_OPEN

未开通聊天室属性自定义设置服务。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 免费基础功能开通聊天室属性自定义设置。

23427

CHATROOM_KEY_NOT_EXIST

聊天室属性不存在。

排查建议：

1. 可通过查询聊天室属性确认属性是否存在。
2. 聊天室销毁后，聊天室中的自定义属性同时销毁。
3. 设置属性时 autoDelete 参数为 1，表示操作用户退出聊天室后属性自动删除。
4. 如果业务层排除主动删除，想了解属性不存在原因，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，聊天室ID，属性 KV，问题发生时间等。

23428

CHATROOM_KV_STORE_NOT_ALL_SUCCESS

聊天室批量设置或删除 KV 部分不成功。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，聊天室ID，问题发生时间等。

23429

CHATROOM_KV_STORE_OUT_LIMIT

聊天室批量设置或删除 KV 数量超限（最多一次 10 条）。

排查建议：数量范围在 1-10 条之间，该范围无法调整。

23431

CHATROOM_KV_SET_ERROR

【已废弃】聊天室设置 KV 失败，出现在两人或者多端同时操作一个 KV。 如果出现该错误，为避免和其他端同时操作，请延时一定时间再试。

24001

HAVNODEVICEID

没有注册 DeviveId 也就是用户没有登陆。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

24002

DEVICEIDISHAVE

device Id 已经存在。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

24009

FEILD

没有对应的用户或 token。

排查建议：

1. 请检查用户是否已经注册，可在融云控制台 > 运营管理 > 用户管理验证 token 是否有效。
2. 建议在融云控制台 > 北极星 > Server Api 调试重新获取一个 token 验证连接

24011

NULLCHANNELNAME

【已废弃】channleName 是空

24015

INTERNALERRROR

服务器内部错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

24360

RC_USER_PROFILE_KEY_NOT_ALLOW_SDK_SET

没有设置该用户托管属性的权限。

排查建议：

1. 客户端不允许设置 uniqueId 参数，请检查是否在调用 updateMyUserProfile 接口时设置了 uniqueId 参数。
2. 如果有设置 uniqueId 的需求，可调用 Server Api 进行设置，详情请参阅设置用户信息。

24361

RC_USER_PROFILE_KEY_NOT_EXIST

用户托管基本属性的 key 列表中没有此 key。

排查建议：修改用户托管信息的 key 不存在，详情请参阅设置用户信息。

24362

RC_USER_PROFILE_EXT_KEY_NOT_EXIST

用户托管扩展属性的 key 列表中没有此 key。

排查建议：修改用户托管信息的 userExtProfile 字段时，key 不存在，扩展用户信息的 Key 需通过融云控制台进行设置，详情请参阅设置用户信息。

24363

RC_USER_PROFILE_EXT_KV_COUNT_EXCEED_LIMIT

超过了可以设置的用户托管扩展属性的最大上限。

排查建议：用户托管扩展属性的最大上限值为 20.

24364

RC_USER_PROFILE_VALUE_LENGTH_EXCEED_LIMIT

用户托管基本属性或扩展属性的 Value，字符超过最大上限。

排查建议：Value 的最大长度为 256 个字符。

24365

RC_USER_PROFILE_QUERY_COUNT_EXCEED_LIMIT

批量查询用户托管资料的数量超限。

排查建议：

1. 客户端一次最多可查询 20 个用户。
2. 使用 Server Api 调用一次最多可查询 100 个用户。详情请参阅批量查询用户资料。

24366

RC_USER_PROFILE_USER_NOT_EXIST

未在用户托管业务中查询到此用户应用号

排查建议：用户应用号未设置。请先设置用户应用[/platform-chat-api/user/user-profiles/set-user-profiles]，再重试

24367

RC_USER_PROFILE_VALUE_CAN_ONLY_BE_NUMBERS

用户托管此属性 Value 只能是数字。

排查建议：性别、角色、级别必须 Int 类型，详情请参阅设置用户信息。

24368

RC_USER_PROFILE_VALUE_EXCEED_RANGE

用户托管此属性 Value 值超过设置取值范围。

排查建议：更新用户信息时，Value 值不能超过设置的取值范围，详情请参阅更新当前用户信息。

24369

RC_USER_PROFILE_SERVICE_UNAVAILABLE

未开启用户信息托管功能。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 功能设置开启用户信息托管服务。

24401

ULTRA_GROUP_SERVICE_UNAVAILABLE

超级群功能未开通。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 超级群服务开启超级群服务。

24402

ULTRA_GROUP_SERVICE_ERROR

超级群服务异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

24403

ULTRA_GROUP_PARAMETER_ERROR

超级群参数错误。

排查建议：请根据文档检查传入参数格式是否正确。

24404

ULTRA_GROUP_UNKNOWN_ERROR

超级群未知异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

24406

NOT_IN_ULTRA_GROUP

非超级群成员。

排查建议：可通过融云控制台 > 北极星 > Server Api 调试超级群模块进行查询，加入等动作。

24408

FORBIDDEN_IN_ULTRA_GROUP

超级群成员被禁言。

排查建议：详情请参阅超级群禁言服务。

24410

ULTRA_GROUP_NOT_EXIST

超级群不存在。

排查建议：可通过融云控制台 > 北极星 > Server Api 调试超级群模块进行创建。

24412

ULTRA_GROUP_JOINED_OVERSIZE

用户加入超级群数量超限。

排查建议：加入超级群最大上限为 100。

24413

ULTRA_GROUP_CHANNELS_OVERSIZE

创建超级群频道，频道数超限。

排查建议：创建超级群频道最大上限为 50。

24414

ULTRA_GROUP_CHANNEL_ID_NOT_EXIST

超级群频道 ID 不存在。

排查建议：

1. 业务层可按需通过融云控制台 > 北极星 > Server Api 调试超级群模块进行创建超级群频道。
2. Server Api 调用详情请参考创建频道文档。

24415

ULTRA_GROUP_MESSAGE_SENT_OVER_FREQUENCY

超级群频道发送消息超限。

排查建议：超级群下每个频道有消息发送频率限制，默认每秒 20 条，频道内每秒发送消息总量超过限制会收到该错误码，建议延时发送或重试发送。

24416

ULTRA_GROUP_USER_NOT_IN_PRIVATE_CHANNEL

用户不在超级群私有频道中。

排查建议：业务层可按需添加私有频道成员。

25101

RECALL_MESSAGE

撤回消息参数无效，请确认撤回消息参数是否正确的填写。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

25102

MESSAGE_STORAGE_SERVICE_UNAVAILABLE

未开通单群聊云存储服务。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > IM 服务管理开通单群聊云存储服务。

25104

RC_SERVER_UNKOWN_ERROR

未知异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

25107

RECALL_MESSAGE_USER_INVALID

IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息，IM 服务有开关，控制只可以撤回自己发送的消息，当服务该开关打开时，撤回别人的消息会报这个错误。

排查建议：

1. 默认 IMLib SDK 撤回消息时，可任意撤回其他用户发送的消息，【IMLib SDK 只允许撤回自己发送的消息】开启后只能撤回自己发送的消息，该服务需要提交工单与我们联系。
2. 通过 Server API 撤回消息时不做判断处理可撤回所有消息。

25402

RC_ENTRUST_SERVER_ERROR

托管服务异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

25403

RC_ENTRUST_SERVER_PARAMETER_ERROR

托管服务参数错误。

排查建议：

1. 请检查用户信息托管相关接口传入参数是否符合文档要求。
2. 如有疑问，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，调用的具体接口和参数等。

25404

RC_GROUP_ILLEGAL_ERROR

非法操作，非群主修改群权限相关，msg 中返回传的对应的 key。

排查建议：只有群主才有权限进行操作，可通过批量查询群组资料确认群主 ID。

25405

RC_GROUP_AUTHORITY_ERROR

没有权限操作。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25406

RC_GROUP_PARAMETER_LENGTH_EXCEED_LIMIT

参数异常，存在长度超限。

排查建议：

1. 请根据接口文档检查参数是否有效，参数长度是否超过限制。
2. 如果参数有效，仍出现该问题，需提供对应接口和参数信息，提交工单与我们联系。

25407

RC_GROUP_PARAMETER_FORMAT_ERROR

参数异常，非法字符。

排查建议：群组属性内置的 key 不存在，

25408

RC_GROUP_PARAMETER_VALUE_CAN_ONLY_BE_NUMBERS

参数值必须是数字。

排查建议：

1. 请根据接口文档检查参数是否有效，参数必须为数字。
2. 如果参数有效，仍出现该问题，需提供对应接口和参数信息，提交工单与我们联系。

25409

RC_GROUP_ID_ALREADY_EXIST

群组 ID 已存在。

排查建议：群组 ID 已经创建过，不需要重新创建。

25410

RC_GROUP_ID_NOT_EXIST

群 ID 不存在。

排查建议：群组 ID 不存在，可按需创建，详情参阅创建群组。

25411

RC_GROUP_MEMBERS_COUNT_EXCEED_LIMIT

群成员超限。

排查建议：

1. 邀请用户加入群组一次最多允许 30 个。
2. 群组总人数最大不超过 3000。

25412

RC_GROUP_MEMBERS_ALREADY_IN_GROUP

群成员 ID 已在当前群组中。

排查建议：该用户已成功加入群组，无须再次执行邀请或者加入的操作。

25413

RC_GROUP_NOT_ALLOW_SDK_OPERATION

不允许通过 SDK 进行此操作。

排查建议：该属性不允许客户端进行修改， 可以在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 群组自定义属性查看。

25414

RC_GROUP_NOT_ALLOW_JOIN

不允许任何人加入，无法加入群组。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25415

RC_GROUP_EXT_KEY_NOT_EXIST

扩展信息 Key 值不存在。

排查建议：可以在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 群组自定义属性添加。

25416

RC_GROUP_REQUEST_OVERFREQUENCY

查询频率超限。

排查建议：群托管 - 用户查询相关接口限制频率，默认 5 次/s，当前只限制 web 端。

25417

RC_GROUP_OWNER_NOT_ALLOW_QUIT_OR_KICK

群主不能被踢出/退出群组/设置管理员。

排查建议：可通过获取指定群成员信息来确认该用户是否为群主。

25418

RC_GROUP_USER_NOT_IN_GROUP

用户 ID 不在群组中。

排查建议：可通过获取指定群成员信息来确认该用户是否在群组中。

25419

RC_GROUP_MANAGER_OR_FOLLOW_COUNT_EXCEED_LIMIT

管理员/关注人数超过上限。

排查建议：

1. 群管理人数最大值为 20。
2. 关注人数最大值为 200。
3. 群人数最大值为 3000。

25420

RC_GROUP_USER_IS_NOT_MANAGER_IN_GROUP

该用户不是当前群的管理员。

排查建议：业务层可按需设置群管理员。

25421

RC_GROUP_APPLICATION_NOT_EXIST

无对应群 ID 和用户 ID 的邀请请求。

排查建议：

1. 邀请信息只保存 7 天，请检查邀请时间是否超过了有效期。
2. 请检查是否有发起邀请，业务层可按需重新邀请他人加入群组。

25422

RC_GROUP_QUERY_GROUP_COUNT_EXCEED_LIMIT

查询群信息个数超限。

排查建议：

1. 查询群信息一次最多查 20 个。
2. 查询群成员一次最多查 100 个。

25423

RC_GROUP_NAME_INVALID

群名称不能为空。

排查建议：详情请参阅创建群组文档。

25424

RC_GROUP_JOIN_GROUP_NEED_MANAGER_ACCEPT

申请进群需要等待管理员审批。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25425

RC_GROUP_OWNER_NOT_ALLOW_BE_MANAGER

不支持将群主设置为管理员。

排查建议：可通过获取指定群成员信息来确认该用户在群中身份。

25426

RC_GROUP_NO_INVITE_PERMISSION

无邀请人进群的权限。

排查建议：

1. 可通过批量查询群组资料确认群的操作权限（permissions字段）。
2. 可通过获取指定群成员信息来确认该用户在群中身份。

25427

RC_GROUP_NEED_INVITEE_ACCEPT

邀请进群需要被邀请人同意。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions 字段）。

25428

RC_GROUP_APPLICATION_ALREADY_HANDLE

请求已被其他管理员处理。

排查建议：业务层可按需提示处理。

25429

RC_GROUP_OLD_GROUP_NOT_ENTRUST

老的群不支持调用托管接口，需要导入后才能调用。

排查建议：详情请参阅群组托管导入。

25430

RC_GROUP_ID_INVALID

群 ID 不合法，包含特殊字符。

排查建议：修改群 ID，确保其只包含英文字母和数字。

25432

RC_PAGE_TOKEN_PARSING_FAILED

pagetoken 解析失败。

排查建议：请检查 pagetoken 是否正确，并且是否为上次请求结果返回的 pagetoken。

25460

RC_FRIEND_ALREADY_FRIEND

已经互为好友，操作无效。

排查建议：可通过获取用户好友列表确认是否互为好友。

25461

RC_FRIEND_NEED_ACCEPT

待对方同意后才能加为好友。

排查建议：可通过两个维度设置添加好友权限，分别是 appkey 级和用户级

1. appkey 级：可通过融云控制台 > 应用配置 > IM 服务 > 信息托管服务- 功能设置好友功能配置进行设置【添加好友权限设置】。
2. 用户级：可通过客户端方法设置加好友权限。

25462

RC_FRIEND_IN_OTHER_BLACK_LIST

在目标用户黑名单中，不能添加好友。

排查建议：业务层可按需移除黑名单中用户。

25463

RC_FRIEND_NOT_IN_OTHER_WHITE_LIST

不在目标用户白名单中，不能添加好友。

排查建议：用户开启了白名单功能，需要被目标用户加入白名单才可以添加好友，详情请参阅用户白名单服务。

25464

RC_FRIEND_IN_MY_BLACK_LIST

目标用户在当前用户黑名单中，不能添加好友。

排查建议：业务层可按需移除黑名单中用户。

25465

RC_FRIEND_NOT_IN_MY_WHITE_LIST

不在当前用户白名单中，不能添加好友。

排查建议：用户开启了白名单功能，需要将目标用户加入白名单才可以添加好友，详情请参阅用户白名单服务。

25466

RC_FRIEND_APPLICATION_NOT_EXIST

操作无效，该好友请求不存在或已经过期。

排查建议：请检查传入的用户 ID 是否正确，好友请求有效期为 7 天，请注意是否过了有效期。

25467

RC_FRIEND_MY_FRIEND_COUNT_EXCEED_LIMIT

当前用户好友数超出上限。

排查建议：好友最大数为 3000，可通过获取用户好友列表查看用户好友总数

25468

RC_FRIEND_OTHER_FRIEND_COUNT_EXCEED_LIMIT

目标用户好友数超出上限。

排查建议：好友最大数为 3000，可通过获取用户好友列表查看用户好友总数

25469

RC_FRIEND_NOT_FRIEND

非好友关系，不能执行此操作。

排查建议：请检查好友关系。

25470

RC_FRIEND_FIELDS_LENGTH_EXCEED_LIMIT

好友自定义属性超出上限。

排查建议：好友自定义属性最多允许设置 10 个。

25471

RC_FRIEND_OTHER_NOT_ALLOW_ADD_FRIEND

对方设置了不允许加为好友。

排查建议：详情请参阅查询添加好友验证等级。

25472

RC_FRIEND_NOT_EXIST

好友不存在。

排查建议：用户 ID 不存在，需先注册用户。

25473

RC_FRIEND_NOT_ALLOW_ADD_SELF

不能添加自己为好友。

排查建议：

1. Server Api 请检查接口传入的 userId 与 targetId，两者不能一致。
2. 客户端接口请检查传入的 userId，需要与当前连接融云服务的用户 ID 两者不能一致。

26001

PUSH_PARAMETER_INVALID

用户级设置服务 请求参数不合法。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，调用的具体接口和参数等。

26002

USER_SETTING_SYNCED_ERROR

表示客户端版本号低，需要同步版本号，可以提交工单申请打开用户级别配置开关。

排查建议：请提交工单申请打开用户级别配置开关。

26004

CONVERSATION_TAG_OVERSIZE

用户会话标签个数超限，最多支持添加 20 个标签。

排查建议：最多支持添加 20 个标签

26005

RC_READ_RECEIPT_V4_INVALID

未开通 v4 已读回执。

排查建议：请提交工单与我们联系。

26007

RC_SERVER_PARAMETER_MESSAGEUIDS_CONFUSED

消息 ID 顺序错误

排查建议：请检查 StartMsgId 和 EndMsgId 参数，需保证 StartMsgId 时间不能小于 EndMsgId 时间。

26009

RC_SERVER_PARAMETER_MESSAGEUID_INVALID

消息 id 不合法。

排查建议：请检查传入的的 messageUid 参数。

26010

RC_SERVER_PARAMETER_INVALID

参数有误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，调用的具体接口和参数等。

26020

RC_SUBSCRIBE_ONLINE_SERVICE_UNAVAILABLE

未开启在线状态订阅功能。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > IM 服务管理开通客户端用户在线状态订阅功能。

26021

RC_BESUBSCRIBED_USERIDS_COUNT_EXCEED_LIMIT

用户被订阅量达到上限，详细查看开发文档。

排查建议：用户被订阅最大值为 5000。

26022

RC_SUBSCRIBED_USERIDS_EXCEED_LIMIT

订阅用户数达到上限，详细查看开发文档。

排查建议：用户订阅最大值为 5000。

26106

RC_FILE_SIZE_EXCEED_LIMIT

上传文件超过最大限制。

排查建议：文件上传最大限制为 100 MB。

26107

INVALID_PARAMETER_SIZE_NOT_FOUND

开启限制未传 size 参数。

排查建议：上传文件时，需传 size 参数，单位为 KB。

30001

RC_NET_CHANNEL_INVALID

当前连接已经被释放。

排查建议：

1. 用户可以根据Events.SUSPEND 或者 Events.DISCONNECT 事件监听返回的错误码，判断连接异常原因。
2. 尝试更换稳定点网络重新连接，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30002

RC_NET_UNAVAILABLE

当前连接不可用。

排查建议：

1. 其他异步 api 接口需要等 connect 连接成功后才能调用。
2. 也可以通过调用getConnectionStatus()方法来确认当前的链接状态，返回值为 0，表示已链接成功。

30003

RC_MSG_RESP_TIMEOUT

客户端发送消息请求，融云服务端响应超时。

排查建议：ack 响应超时，稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30005

RC_HTTP_REQ_FAIL

请求连接导航地址失败。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30007

RC_NAVI_REQ_FAILED

导航返回结果异常。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30010

RC_SOCKET_NOT_CREATED

创建连接失败。

排查建议：多个 cmp 地址连接失败，稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30011

RC_SOCKET_DISCONNECTED

链接断开。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30012

RC_PING_EXCEED_LIMIT

PING 失败。

排查建议：一般都是网络问题导致 ping 失败，该种情况 SDK 会进行重连，直到用户网络恢复连接成功。

30016

RC_MSG_CONTENT_EXCEED_LIMIT

消息大小超限，消息体（序列化成 JSON 格式之后的内容）最大 128k bytes。

排查建议：

1. 常见的原因：发送图片消息时，传入的缩略图过大，建议生成的 base64 缩略图最大不能超过 80 kb。
2. 业务层需控制 JSON.stringify 后的 content 长度不超过 128k，避免消息体过大。

30019

RC_NETWORK_DOWN

网络连接不可用。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30021

RC_TCP_DISCONNECTED_NO_RMTP

TCP 连接成功，RMTP 连接失败。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

31000

RC_CONN_ACK_TIMEOUT

连接 ACK 超时。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

31001

RC_CONN_PROTO_VERSION_ERROR

信令版本错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

31002

RC_CONN_IDENTIFIER_REJECTED

客户端 info 字段格式错误。

排查建议：

1. 正确格式：{平台类型}-{设备信息}-{sdk版本}，其中设备信息：{手机类型}|{手机型号}|{网络类型，4G/WIFI}|{运营商标识， 移动/电信/联通}
2. 请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

31003

RC_CONN_SERVER_UNAVAILABLE

小程序（或桌面端）服务未开通。

排查建议：可以在融云控制台 > 应用配置 > IM 服务 > 小程序服务设置(桌面版服务设置)进行开通。

31004

RC_CONN_TOKEN_INCORRECT

Token 无效；AppKey 和 Token 不匹配；Token 过期。

排查建议：

1. 请检查应用初始化传入的 appkey 与应用 server 获取 token 传入的 appkey 是否一致。
2. 请检查融云控制台 > 应用配置 > 基本信息设置 token 的有效期。
3. 建议在融云控制台 > 北极星 > Server Api 调试重新获取一个 token 验证连接。

31006

RC_CONN_REDIRECTED

连接重定向。

排查建议：

1. 一般服务扩缩容时，落点已经改变，此时 userId 链接到旧的节点时，会触发该错误。
2. SDK 内部已经实现了重新连接请求导航获取 CMP 地址的逻辑。

31008

RC_CONN_APP_BLOCKED_OR_DELETED

AppKey 被封禁或已删除。

排查建议：用户可以在融云控制台 > 应用管理申请恢复。

31009

RC_CONN_USER_BLOCKED

连接失败，用户被封禁（客户端主动连接失败返回）。

排查建议：业务层按需解除封禁。

31010

RC_DISCONN_KICK

用户被踢下线。

排查建议：

1. 默认的情况下，同一用户账号可在移动端、Web 端、桌面端、小程序端最多一个设备上同时在线。
2. 如果想在同类型设备多端登录（比如同账户在多 web 标签页登入），请根据多端同时在线文档进行操作。

31011

RC_DISCONN_EXCEPTION

用户被封禁，导致 IM 连接被动断开。

排查建议：业务层按需解除封禁。

31020

RC_CONN_TOKEN_EXPIRED

Token 已过期。

排查建议：

1. 请检查融云控制台 > 应用配置 > 基本信息设置 token 的有效期。
2. 建议在融云控制台 > 北极星 > Server Api 调试重新获取一个 token 验证连接。

31022

RC_CONN_HOSTNAME_ERROR

页面域名不在安全域名白名单内，需通过融云控制台添加安全域名配置。

排查建议：请检查当前页面域名是否在安全域名配置中，如果不存在请按需添加。

31023

RC_DISCONN_SAME_CLIENT_ON_LINE

开启允许客户端 SDK 控制重连互踢策略后，该错误码标识已有同类型端在线。

排查建议：详情请参阅重连机制与重连互踢文档。

31024

RC_LISCENSE_COUNT_OUT_OF_LIMIT

连接总数量超过服务设定的并发限定值（私有云专属）。

排查建议：

1. 连接数上限可在私有云管理后台 > 应用配置 > 应用信息查看。
2. 该上限作用对象是 appkey，如果用户要修改上限值，必须更换新识别码。

31029

RC_ACCOUNT_CANCELLATION

用户已销户。

排查建议：

1. 请检查是否已经销户，详情请参阅查询已注销用户文档。
2. 如果已经销户，请按需重新激活用户 ID，详情请参阅重新激活用户 ID文档。

31030

RC_LICENSE_EXPIRED

私有云 License 检查不通过;APP License 过期。

排查建议：

1. 请分别检查私有云管理后台的 识别码 和 License 信息是否过期。
2. 如果已过期，请联系商务。
3. 如果使用的是鸿蒙 SDK，请联系商务。

32001

RC_QUERY_ACK_NO_DATA

协议层内部错误，查询，上传，下载过程中数据错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

32002

RC_MSG_DATA_INCOMPLETE

协议层内部错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

32011

RC_UDP_DISCONNECTED

服务器主动断开连接（仅 quic 协议下触发）。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

32054

RC_TCP_RESET

链接被服务器中断，可能原因是运营商认为此链接非法或无效，直接断开 出现此错误码后，SDK 会自动触发重连，App 无需处理。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

32061

CONNECTION_REFUSED

连接被拒绝。

排查建议：与 31006 重定向等价处理，SDK 内部实现重新请求导航获取 CMP 地址并重新连接。

33000

PROTOCOL_MESSAGE_SAVED_ERROR

将消息存储到本地数据时失败。 发送或插入消息时，消息需要存储到本地数据库，当存库失败时，会回调此错误码。

排查建议：

1. 请检查用户设备内存是否充足。
2. 是否执行 connect 连接成功。
3. 连接正常并且内存充足，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33001

BIZ_ERROR_CLIENT_NOT_INIT

未初始化。

排查建议：请检查是否有执行 init 初始化接口。

33002

BIZ_ERROR_DATABASE_ERROR

数据库错误。

排查建议：

1. 请检查是否执行 init 初始化接口以及调用 connect 连接成功。
2. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33003

BIZ_ERROR_INVALID_PARAMETER

开发者接口调用时传入的参数错误。

排查建议：请检查传入的参数格式是否符合接口注释的相关说明。

33004

BIZ_ERROR_NO_CHANNEL

通道无效。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33006

BIZ_ERROR_CONNECTING

连接中，再调用 connect 被拒绝。

排查建议：请检查是否有重复调用 connect 接口。

33007

MSG_ROAMING_SERVICE_UNAVAILABLE

历史消息云存储业务未开通。

排查建议：

1. 请在融云控制台 > 应用配置 > IM 服务 > IM 服务管理检查是否已经开通历史消息云存储业务。
2. 如果已经开通并且刚开通 2 个小时左右，可以卸载重装试下（更新导航信息）。

33008

MSG_INSERT_ERROR

消息存入本地数据库失败。

排查建议：

1. 请检查是否执行 init 初始化接口以及调用 connect 连接成功。
2. 请检查设备内存是否充足。
3. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33009

MSG_DEL_ERROR

聊天室被回收。

排查建议：可在融云控制台 > 北极星 > Server Api 调试查看聊天室信息进行确认。

33100

TAG_NOT_EXIST

标签不存在。

排查建议：

1. 请通过获取标签列表，确认标签是否存在，详情请参阅文档。
2. 如果不存在按需创建，详情请参阅文档。

33101

TAG_EXISTS

标签已存在。

排查建议：请通过获取标签列表，确认标签是否存在，详情请参阅文档。

33102

NO_TAG_IN_CONVER

标签不在会话中。

排查建议：请通过获取指定会话下的所有标签，确认标签是否存在，详情请参阅文档。

34001

RC_CONNECTION_EXIST

连接已存在。

排查建议：连接已存在，无需再次调用连接。

34005

PACKAGE_ENVIRONMENT_ERROR

连接环境不正确。

排查建议：

1. 该错误码适用于私有云，公有云用户可忽略。
2. 私有云环境使用公有云 SDK 会报此错误。
3. 私有云 SDK 都会携带 enterprise 标识。
4. 如果您无法确认可联系商务。

34006

CONNECTION_TIMEOUT

连接超时。

排查建议：

1. 当前连接融云服务异常，用户可在监听连接状态判断是否连接成功。
2. 稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34008

MESSAGE_KV_NOT_SUPPORT

消息不能被扩展，只支持单群聊，其他类型消息会返回此错误，消息在发送时，Message 对象的属性 canIncludeExpansion 置为 true 才能进行扩展。

排查建议：请检查在消息发送前是否设置了消息的可扩展属性 canIncludeExpansion 为 true，详情请参阅 sendMessage 接口说明。

34010

EXPANSION_LIMIT_EXCEET

消息扩展大小超出限制。

排查建议：默认消息扩展字典 key 长度不超过 32 个字符，value 长度不超过 4096 个字符，设置的 Expansion 键值对不超过 300 个

34011

UPLOAD_FAIL

媒体消息媒体文件 http 上传失败。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34013

CONVER_OUT_LIMIT_ERROR

标签中添加/删除的会话数量超限。

排查建议：最多支持添加/删除 1000 个会话。

34014

READ_RECEIPT_ERROR

群已读回执版本不支持。

排查建议：Web 端 sendReadReceiptResponseV2 已经根据导航下发的值判断走不同的逻辑，所以公有云和私有云不会返回该错误码。

34016

PUSH_CONTENT_CONFIG_SERVICE_UNAVAILABLE

用户级别设置未开通。

排查建议：请提交工单与我们联系。

34018

MEDIA_EXCEPTION

媒体文件上传异常，媒体文件不存在或文件大小为 0。

排查建议：

1. 使用 instanceof 检查传进去 file 是否属于 File 对象，代码示例如下：

  // 假设 file 是您业务层获取到的文件
  file instanceof File

2. 如果您调用的是 RongIMLib.sendImageMessage 方法，检查传进入的 file 类型是否为 image，代码示例如下：

  // 假设 file 是您业务层获取到的文件
  file.type.match(/^image\//)

3. 如果您调用的是 RongIMLib.sendHQVoiceMessage 方法，检查传入的 file 类型是否为 audio，代码示例如下：

  // 假设 file 是您业务层获取到的文件
  file.type.match(/^audio\//)

34022

METHOD_NOT_SUPPORT

该接口不支持超级群会话。

排查建议：请检查传入的会话类型 conversationType 是否为 10，具体会话类型请参阅文档。

34201

CONVERSATION_TYPE_NOT_SUPPORT

开发者调用的接口不支持传入的会话类型。

排查建议：请检查传入的参数格式是否符合接口注释的相关说明。

34202

INVALID_PARAMETER_TIMESTAMP

开发者接口调用时传入的时间戳非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34203

INVALID_PARAMETER_MESSAGE_UID

开发者接口调用时传入的 uid（服务器消息唯一 id）非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34204

INVALID_PARAMETER_MESSAGE_ID

开发者接口调用时传入的 messageId 非法或者找不到对应的 Message。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34205

INVALID_PARAMETER_MESSAGE_CONTENT

开发者接口调用时传入的 Message 非法，或者 MessageContent 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34206

MSG_LIMIT_ERROR

开发者接口调用时传入的 messageList 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34207

INVALID_PARAMETER_MEDIA_TYPE

开发者接口调用时传入的 mediaType 非法。

排查建议：请检查传入的参数是否属于 FileType 枚举。

34209

INVALID_PARAMETER_CONVERSATION_TYPE

开发者接口调用时传入的 ConversationType 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34210

INVALID_PARAMETER_TARGET_ID

开发者接口调用时传入的 targetId 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34211

INVALID_PARAMETER_CHANNEL_ID

开发者调用频道相关接口时传入的 channelId 非法。

排查建议：请检查传入的参数是否为 String 类型，并且长度在 0-20 个字符之间，不能有下划线。

34212

INVALID_PARAMETER_TAG_ID

开发者接口调用时传入的 tagId 非法。

排查建议：请检查传入的参数是否为 String 类型，并且长度在 1-10 个字符之间。

34213

INVALID_PARAMETER_TAG_NAME

开发者接口调用时传入的 tagName 非法。

排查建议：请检查传入的参数是否为 String 类型，并且长度在 1-15 个字符之间。

34214

INVALID_PARAMETER_USER_ID

开发者接口调用时传入的 userId 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34215

INVALID_PARAMETER_USERIDLIST

开发者接口调用时传入的 userIdList 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34217

INVALID_PARAMETER_DOWNLOADMEDIAFILENAME

开发者接口调用时传入的 downloadMediaFileName 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34220

INVALID_PARAMETER_MESSAGE_EXPANSION

开发者接口调用时传入的 MessageExpansion 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34225

INVALID_PARAMETER_CONVERSATION

conversation 参数非法。

排查建议：请检查传入的参数是否属于 IConversationOption 类型。

34228

INVALID_PARAMETER_NOTIFICATION_LEVEL

PushNotificationLevel 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34229

INVALID_PARAMETER_MESSAGE_ARRAY

开发者调用接口传入的 messageIds 参数非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34230

INVALID_PARAMETER_RECEIVED_STATUS

开发者调用接口传入的 ReceivedStatus 参数非法。

排查建议：

1. 如果传入的参数是 receivedStatus 请检查传入的参数是否属于 ReceivedStatus 枚举。
2. 如果传入的参数是 receivedStatusInfo 请检查传入的参数是否属于 IReceivedStatusInfo 类型。

34231

INVALID_PARAMETER_CHANNEL_TYPE

无效的超级群频道类型。

排查建议：请检查传入的参数是否属于 UltraGroupChannelType 枚举。

34232

INVALID_PARAMETER_COUNT

开发者接口调用时传入的 count 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34235

INVALID_PARAMETER_MEDIA_URL

开发者调用接口传入的 mediaUrl 地址非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34236

INVALID_PARAMETER_UNIQUE_ID

开发者调用接口传入的 uniqueId 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34238

INVALID_PARAMETER_PROXY

非法的代理配置，RongIMProxy 为空或者非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34239

INVALID_PARAMETER_TESTHOST

开发者接口调用 testProxy 时传入的代理测试服务非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34242

INVALID_PARAMETER_CONVERSATIONS

开发者调用接口传入的 conversations 参数非法。

排查建议：

1. 请检查传入的参数是否为 Array 类型。
2. 数组长度需大于 0。
3. 数组中每个元素需为 IConversationOption 类型。

34244

INVALID_PARAMETER_SENT_STATUS

开发者调用接口传入的 Message.SentStatus 参数非法。

排查建议：请检查传入的参数是否属于 SentStatus 枚举。

34245

RC_CONN_PROXY_UNAVAILABLE

设置的代理地址不可用。

排查建议：用户当前的链接状态不是断开的，建议调用 disconnect 先断开连接再重试。

34259

INVALID_PARAMETER_RTCROOMID

参数 rtcRoomID 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34260

INVALID_PARAMETER_KEY

参数 key 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34261

INVALID_PARAMETER_KEYS

参数 keys 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34262

INVALID_PARAMETER_VALUE

参数 value 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34263

INVALID_PARAMETER_ENTRIES

参数 entries 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34264

INVALID_PARAMETER_NOTIFICATION_EXTRA

参数 notificationExtra 非法。

排查建议：

1. 请检查传入的参数是否为 String 类型。
2. 字符串长度不能超过 2 * 1024 个字符。

34272

INVALID_PARAMETER_BEFORE

参数 before 非法。

排查建议：

1. 请通过 API DOC 检查接口参数类型是否正确。
2. 参数必须为整数且大于等于 0。

34273

INVALID_PARAMETER_AFTER

参数 after 非法。

排查建议：

1. 请通过 API DOC 检查接口参数类型是否正确。
2. 参数必须为整数且大于等于 0。

34274

INVALID_PARAMETER_KEYWORD

参数 keyword 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34276

INVALID_PARAMETER_OFFSET

参数 offset 非法。

排查建议：

1. 请通过 API DOC 检查接口参数类型是否正确。
2. 参数必须为整数且大于等于 0。

34277

INVALID_PARAMETER_START_TIME

参数 start time 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34278

INVALID_PARAMETER_END_TIME

参数 end time 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34279

INVALID_PARAMETER_LIMIT

参数 limit 非法。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34280

INVALID_MESSAGE_DIRECTION

MessageDirection 非法。

排查建议：请检查参数是否属于 MessageDirection 类型。

34284

INVALID_PARAMETER_CONVERSATION_TYPE_LIST

参数 ConversationType 列表非法。

排查建议：

1. 请检查传入参数是否为 Array 类型。
2. 数组元素为 ConversationType 枚举。

34287

INVALID_PARAMETER_CONVERSATION_LIST

开发者调用接口传入的 conversationList 数组非法。

排查建议：

1. 请检查传入参数是否为 Array 类型。
2. 数组长度范围为 1-100。
3. 数组元素为 IConversationOption 类型。

34288

INVALID_PARAMETER_CLEAR_MESSAGE_OPTION_LIST

开发者调用接口传入的 ClearMessageOption 数组非法。

排查建议：

1. 请检查传入参数是否为 Array 类型。
2. 数组长度范围为 1-20。
3. 数组元素为 IClearMessageOption 类型。

34289

INVALID_PARAMETER_START_MESSAGE_UID

参数 startMessageUID 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34290

INVALID_PARAMETER_END_MESSAGE_UID

参数 endMessageUID 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

34291

READ_RECEIPT_V4_NOT_SUPPORT

不支持 V4 已读回执功能。

排查建议：

1. 目前只有 Global IM UIKit 支持 v4 已读回执功能。
2. 如果使用 Global IM UIKit 仍然出现请提交工单与我们联系。

34296

RC_DIRECTIONAL_MESSAGE_INVALID_CONVERSATION_TYPE

发送定向消息时，传入的会话类型不支持。

排查建议：目前仅支持传入 GROUP，ULTRA_GROUP 的会话类型，会话类型详情请参阅文档

34306

INVALID_PARAMETER_SUBSCRIBE_TYPE

订阅事件传入的订阅类型非法。

排查建议：请检查传入的 subscribeType 是否属于 SubscribeType 枚举

34307

INVALID_PARAMETER_SUBSCRIBE_EXPIRY

订阅事件传入的订阅时长非法[60s ~ 30天]。

排查建议：传入的是时间戳，即最小时间戳值为：60，最大时间戳值为: 30 * 24 * 60 * 60

34308

INVALID_PARAMETER_SUBSCRIBE_PUBLISHER_USERIDS

订阅事件传入的订阅用户列表空或者数据类型非法。

排查建议：

1. 请检查传入的参数是否为 Array 类型。
2. 长度在 1 - 200 范围内。
3. 数组中的元素必须为字符串类型，且长度在 1 - 64 范围内。

34309

INVALID_PARAMETER_SUBSCRIBE_PAGESIZE

订阅事件传入的分页大小非法。

排查建议：

1. 请检查传入的参数是否为 Number 类型。
2. 值在 1 - 200 范围内。

34310

SUB_PROCESS_EXIT

子进程意外终止，如果是已连接状态，SDK 会自动重连。

排查建议：

1. 在 electron 主进程初始化的时候可以设置 runInMainProcess 为 true，详情请参考Electron 初始化文档。
2. 如果崩溃会直接弹框提示，可将提示截图发送到工单，便于排查。

34311

ADDON_NOT_EXIST

addon 模块不存在。

排查建议：

1. 该问题是因为 .node 文件未找到，请检查 node_modules/@rongcloud/electron/binding 目录下是否有对应 .node 文件，如果没有，请重新安装依赖。
2. 如果 SDK 版本小于 5.8.3 版本，请升级 SDK 至最新版本，具体版本号请参阅版本描述。

34312

INVALID_PARAMETER_USER_PROFILE

参数 userProfile 非法。

排查建议：请检查传入的参数是否属于 IUserProfileInfo 类型。

34313

INVALID_PARAMETER_USER_PROFILE_VISIBILITY

参数 userProfileVisibility 非法。

排查建议：请检查传入的 userProfileVisibility 是否属于 UserProfileVisibility 枚举

34314

INVALID_PARAMETER_EXTRA

参数 extra 无效。

排查建议：请检查传入的 extra 是否为字符串类型，且长度在 0 - 128 范围内。

34318

INVALID_PARAMETER_GROUP_INFO

开发者接口调用时传入的参数 GroupInfo 非法。

排查建议：请检查传入的 GroupInfo 是否属于 IGroupInfoOption 类型。

34319

INVALID_PARAMETER_GROUP_ID

开发者接口调用时传入的参数 groupId 非法。

排查建议：

1. 请检查传入的 groupId 是否为字符串类型。
2. 去除空格换行后，长度在 1 - 64 范围内。

34320

INVALID_PARAMETER_GROUP_NAME

开发者接口调用时传入的参数 groupName 非法。

排查建议：

1. 请检查传入的 groupName 是否为字符串类型。
2. 去除空格换行后，长度在 1 - 64 范围内。

34321

INVALID_PARAMETER_GROUP_IDS

开发者接口调用时传入的参数 groupIds 非法。

排查建议：

1. 请检查传入的 groupIds 是否为 Array 类型。
2. 长度在 1 - 200 范围内。
3. 数组中的元素必须为字符串类型，且去除空格换行后，长度在 1 - 64 范围内。

34322

INVALID_PARAMETER_GROUP_MEMBER_ROLE

开发者接口调用时传入的参数 GroupMemberRole 非法。

排查建议：请检查传入的 GroupMemberRole 是否属于 GroupMemberRole 枚举。

34323

INVALID_PARAMETER_GROUP_APPLICATION_STATUS

开发者接口调用时传入的参数 GroupApplicationStatus 非法。

排查建议：

1. 请检查传入的参数为 Array 类型。
2. 长度不为 0。
3. 数组中的元素必须符合 GroupApplicationStatus 枚举定义。

34324

INVALID_PARAMETER_GROUP_APPLICATION_DIRECTION

开发者接口调用时传入的参数 GroupApplicationDirection 非法。

排查建议：

1. 请检查传入的参数为 Array 类型。
2. 长度不为 0。
3. 数组中的元素必须符合 GroupApplicationDirection 枚举定义。

34325

INVALID_PARAMETER_NICK_NAME

开发者接口调用时传入的参数 nickname 非法。

排查建议：

1. 请检查传入的参数是否为字符串类型。
2. 去除空格换行后，长度在 1 - 64 范围内。

34326

INVALID_PARAMETER_REASON

开发者接口调用时传入的参数 reason 非法。

排查建议：

1. 请检查传入的参数是否为字符串类型。
2. 去除空格换行后，长度在 0 - 128 范围内。

34327

INVALID_PARAMETER_REMARK

开发者接口调用时传入的参数 remark 非法。

排查建议：

1. 请检查传入的参数是否为字符串类型。
2. 去除空格换行后，长度在 0 - 64 范围内。

34328

INVALID_PARAMETER_PAGING_QUERY_OPTION

开发者接口调用时传入的参数 PagingQueryOption 非法。

排查建议：请检查传入的参数是否属于 IPagingQueryOption 类型。

34330

INVALID_PARAMETER_QUERY_FRIENDS_DIRECTION_TYPE

开发者接口调用时传入的参数 QueryFriendsDirectionType 非法。

排查建议：请检查传入的参数是否属于 QueryFriendsDirectionType 枚举。

34331

INVALID_PARAMETER_DIRECTION_TYPE

开发者接口调用时传入的参数 DirectionType 非法。

排查建议：请检查传入的参数是否属于 DirectionType 枚举。

34332

INVALID_PARAMETER_FRIEND_APPLICATION_TYPE

开发者接口调用时传入的参数 FriendApplicationType 非法。

排查建议：请检查传入的参数是否属于 FriendApplicationType 枚举。

34333

INVALID_PARAMETER_FRIEND_APPLICATION_STATUS

开发者接口调用时传入的参数 FriendApplicationStatus 非法。

排查建议：请检查传入的参数是否属于 FriendApplicationStatus 枚举。

34334

INVALID_PARAMETER_FRIEND_ADD_PERMISSION

开发者接口调用时传入的参数 FriendAddPermission 非法。

排查建议：请检查传入的参数是否属于 FriendAddPermission 枚举。

34335

INVALID_PARAMETER_FRIEND_INFO_EXT_FIELDS

开发者接口调用时传入的参数 extProfile 非法。

排查建议：

1. 请检查传入的是否为对象类型。
2. 对象中 value 必须是字符串类型。

35001

GROUP_SYNC_ERROR

【已废弃】群组信息异常。

35002

GROUP_MATCH_ERROR

【已废弃】匹配群信息异常。

35004

NOT_SUPPORT

方法未支持。

排查建议：该方法独属于 @rongcloud/electron，适配该 SDK 请参阅集成方案(Electron)文档

35005

MAIN_PROCESS_ERROR

主进程内方法错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，调用的接口和参数信息，问题发生时间等。

35007

CAN_NOT_RECONNECT

【已废弃】已连接或者内部重连中，不允许调用重连，需先调用 disconnect 方法。

35008

SERVER_UNAVAILABLE

无可用的 IM 服务地址。

排查建议：稍后重试或者更换稳定网络后重试，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

35009

HOSTNAME_ERROR

【已废弃】Web 端设置安全域名后，连接端域名不在安全域名范围内。

35010

HAS_OHTER_SAME_CLIENT_ON_LINE

【已废弃】开启`禁止把已在线客户端踢下线`开关后，该错误码标识已有同类型端在线，禁止链接。

35011

METHOD_NOT_AVAILABLE

IM 在初次连接成功后，需立即同步消息，标记上线，然后获取全量超级群会话列表，列表同步完成前，所有超级群相关功能接口应不可用。

排查建议：SDK 事件监听中有 Events.ULTRA_GROUP_ENABLE，该事件监听表示：超级群会话列表同步完成，可以调用超级群相关接口，详情请参阅事件监听文档。

35014

METHOD_ONLY_SUPPORT_ULTRA_GROUP

该功能仅支持超级群。

35015

DRAFT_SAVE_ERROR

保存草稿失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，传入的参数，问题发生时间等。

35016

DRAFT_REMOVE_ERROR

删除草稿失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，传入的参数，问题发生时间等。

35020

CONVER_REMOVE_ERROR

删除会话失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，传入的参数，问题发生时间等。

35021

CONVER_GET_ERROR

获取会话失败。

排查建议：

1. 获取指定会话时，SDK 内存态中没有该数据
2. 可调用 getConversationList 方法 获取会话列表，判断会话列表中是否存在该会话。

35022

SEARCH_PROPS_LIMIT_ERROR

搜索字段对应消息错误。

排查建议：请检查传入的参数是否为字符串类型，且长度不为 0。

35024

INVALID_PARAMETER_MESSAGE_TYPE

开发者调用时传入的消息类型无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35025

INVALID_PARAMETER_ORDER

开发者调用时传入的 order 无效。

排查建议：请检查参数值是否为 0 | 1 。

35028

INVALID_PARAMETER_DRAFT

开发者调用时传入的 draft 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35029

INVALID_PARAMETER_MESSAGE

开发者调用时传入的 message 无效， message 应是对象或者 BaseMessage 的子类。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35030

INVALID_PARAMETER_PUSH_CONTENT

开发者调用 sendMessage 时传入的 pushContent 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35031

INVALID_PARAMETER_SENDOPTIONS

开发者调用上传语法糖接口时传入的 sendOptions 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35032

INVALID_PARAMETER_CONTENT_DISPOSITION

开发者调用上传语法糖接口时传入的 contentDisposition 无效。

排查建议：

1. 请检查参数值是否为 inline | attachment。
2. inline 表示在线预览
3. attachment 表示下附件载

35033

INVALID_PARAMETER_SAVE_NAME

获取文件时，参数 saveName 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35034

INVALID_PARAMETER_SERVER_TYPE

获取文件时，参数 serverType 无效。

排查建议：

1. 请检查传入的参数是否属于 Nunmber 类型。
2. 目前支持的值有 1 | 2 | 3 | 4 | 5，分别对应七牛上传/阿里云上传/亚马逊上传/stc上传/minio上传。

35035

INVALID_PARAMETER_CLEAN_SPACE

开发者调用时传入的 cleanSpace 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35036

INVALID_PARAMETER_CAN_INCLUDE_EXPANSION

开发者调用时传入的 canIncludeExpansion 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35037

INVALID_PARAMETER_DISABLE_NOTIFICATION

开发者调用时传入的 disableNotification 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35038

INVALID_PARAMETER_CHECK_DUPLICATE

开发者调用时传入的 checkDuplicate 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35039

INVALID_PARAMETER_IS_AUTO_DELETE

开发者调用时传入的 isAutoDelete 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35040

INVALID_PARAMETER_IS_SEND_NOTIFICATION

开发者调用时传入的 isSendNotification 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35041

INVALID_PARAMETER_IS_FORCE

开发者调用时传入的 isForce 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35042

INVALID_PARAMETER_IS_TOP

开发者调用时传入的 isTop 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35043

INVALID_PARAMETER_IS_UPDATE_TIME

开发者调用时传入的 isUpdateTime 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35044

INVALID_PARAMETER_CONTAIN_MUTED

开发者调用时传入的 containMuted 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35045

INVALID_PARAMETER_IS_STATUS_MESSAGE

开发者调用时传入的 isStatusMessage 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35046

INVALID_PARAMETER_IS_MENTIONED

开发者调用时传入的 isMentioned 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35047

INVALID_PARAMETER_IS_VOIP_PUSH

开发者调用时传入的 isVoipPush 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35048

INVALID_PARAMETER_MENTIONED_TYPE

开发者调用时传入的 mentionedType 无效。

排查建议：请检查传入的参数的值是否为 1 | 2。

35049

INVALID_PARAMETER_PUSH_CONFIG

开发者调用时传入的 pushConfig 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

35050

INVALID_PARAMETER_PUSH_DATA

开发者调用时传入的 pushData 无效。

排查建议：请通过 API DOC 检查接口参数类型是否正确。

36001

CHATROOM_ID_ISNULL

【已废弃】加入聊天室 ID 为空。

36002

CHARTOOM_JOIN_ERROR

【已废弃】加入聊天室失败。

36003

CHATROOM_HISMESSAGE_ERROR

【已废弃】拉取聊天室历史消息失败。

36004

CHATROOM_KV_NOT_FOUND

【已废弃】聊天室 KV 未找到。

37001

BLACK_ADD_ERROR

【已废弃】加入黑名单异常。

37002

BLACK_GETSTATUS_ERROR

【已废弃】获得指定人员再黑名单中的状态异常。

37003

BLACK_REMOVE_ERROR

【已废弃】移除黑名单异常。

38001

DRAF_GET_ERROR

【已废弃】获取草稿失败。

41002

QNTKN_GET_ERROR

【已废弃】获取七牛token失败。