状态码

本文档列出了 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

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

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

407

NOT_IN_WHITELIST

对方开启了只接收白名单的信息，但己方不在白名单中，发送消息失败。

排查建议：将己方添加到接收方的白名单中

20106

FORBIDDEN_IN_PRIVATE

在单聊中已被禁言。

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

20109

SYS_CONVERSATION_NOT_SUPPORT_MESSAGE

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

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

20112

DANGEROUS_CONTENT

消息内容存在敏感词。

排查建议：修改的消息内容命中了敏感词，可以查看配置的敏感词。

20113

CONTENT_REVIEW_REJECTED

消息内容未通过审核。

排查建议：修改的消息被内容审核拦截，您可以提供一下接受者 ID，和修改时间提工单这边分析下。

20114

MESSAGE_OVER_MODIFY_TIME_FAIL

消息超过可修改时间。

排查建议：修改时间限制：仅支持修改消息发送后 24 小时内的消息。

20115

MESSAGE_SIZE_EXCEEDED

消息大小超出限制。

排查建议：修改后的消息内容最大 10 KB。

20116

MESSAGE_UNSUPPORTED_MODIFY

消息不支持修改。

排查建议：RC:StreamMsg 该消息类型不支持修改

20512

CLOUD_DATA_CENTER_INVALID

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

排查建议：

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

20604

SEND_FREQUENCY_TOO_FAST

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

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

20605

OPERATION_BLOCKED

操作被禁止，此错误码已被弃用。

排查建议：此错误码已被弃用

20606

OPERATION_NOT_SUPPORT

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

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

20607

REQUEST_OVER_FREQUENCY

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

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

21406

NOT_IN_DISCUSSION

不在讨论组。

排查建议：此错误码已被弃用

21501

SENSITIVE_SHIELD

发送的消息由于包含敏感词而被屏蔽，发送方无法发送消息。

排查建议：

1. 请检查后台的敏感词配置，路径为：融云控制台 > 应用配置 > 安全&审核 > 敏感词设置。
2. 过滤方式为屏蔽消息。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

21502

SENSITIVE_REPLACE

消息中敏感词已经被替换，接收方可以收到被替换之后的消息。

排查建议：

1. 请检查后台的敏感词配置，路径为：融云控制台 > 应用配置 > 安全&审核 > 敏感词设置。
2. 过滤方式为替换敏感词。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

22201

MESSAGE_EXPAND_NOT_EXIST

设置扩展消息，但是原始消息不存在。

排查建议：

1. 超级群历史消息默认存储 7 天，超过 7 天的消息会被删除
2. 单群聊历史消息默认存储 180 天，超过 180 天的消息会被删除
3. 原消息可能已经被手动删除，可通过获取超级群会话历史消息和获取单群聊会话历史消息确认原消息是否存在。

22202

MESSAGE_EXPAND_NOT_SUPPORT

设置扩展消息，但是原始消息不支持扩展。

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

22203

MESSAGE_EXPAND_FORMAT_ERROR

设置扩展消息，扩展内容格式错误。

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

22204

MESSAGE_EXPAND_NOT_AUTHORIZED

设置扩展消息，无操作权限。

排查建议：

1. 修改超级群扩展时传入的会话类型参数错误，请检查传入的会话类型值是否为 10。
2. 修改超级群消息时，请检查是否为超级群消息发送人。

22406

NOT_IN_GROUP

不在该群组中。

排查建议：

1. 需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行查询，加入等动作。
2. 如果用户在群组中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，群组ID，问题发生时间等。

22408

FORBIDDEN_IN_GROUP

在群组中已被禁言。

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

23406

NOT_IN_CHATROOM

不在该聊天室中。

排查建议：

1. 可按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_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. 也可在需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_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 服务的服务购买页面开通聊天室消息云端存储服务。

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 服务功能配置页面（page_code: im_service_config）中，进入 聊天室 > 聊天室属性自定义设置，开通此功能。

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. 请检查用户是否已经注册。可按控制台内嵌指南嵌入用户管理页面（page_code: user_manage）后，在自己的管理后台中验证 token 是否有效。
2. 建议按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，重新获取一个 token 验证连接

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

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

排查建议：用户信息托管功能已默认开通，可直接使用。如有问题请联系技术支持。

24401

ULTRA_GROUP_SERVICE_UNAVAILABLE

超级群功能未开通。

排查建议：超级群功能仅尊享版支持，已默认开通。如有问题请联系技术支持。

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

非超级群成员。

排查建议：可在需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行查询，加入等动作。

24408

FORBIDDEN_IN_ULTRA_GROUP

超级群成员被禁言。

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

24410

ULTRA_GROUP_NOT_EXIST

超级群不存在。

排查建议：需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行创建。

24411

ULTRA_GROUP_MEMBERS_OVERSIZE

超级群成员超限制。

排查建议：保留字段， server 端暂未使用

24412

ULTRA_GROUP_JOINED_OVERSIZE

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

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

24413

ULTRA_GROUP_CHANNELS_OVERSIZE

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

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

24414

ULTRA_GROUP_CHANNEL_ID_NOT_EXIST

超级群频道 ID 不存在。

排查建议：

1. 业务层可按需在控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_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 服务的服务购买页面开通单群聊消息云端存储服务。

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 进行此操作。

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

25414

RC_GROUP_NOT_ALLOW_JOIN

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

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

25415

RC_GROUP_EXT_KEY_NOT_EXIST

扩展信息 Key 值不存在。

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

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

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

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

1. App key 级：需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入好友 > 添加好友权限设置进行设置。
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 两者不能一致。

25474

RC_FRIEND_NOT_SUPPORT_ROBOT

不支持添加机器人为好友。

排查建议：可以查看机器人列表，确认用户是否是机器人。

25480

SERVICE_INFORMATION_AUDIT_FAILED

托管资料信息审核不通过。

排查建议：托管资料信息审核不通过，请提供调用的接口和时间，提交工单与我们联系。

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 已读回执。

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

26006

RC_SERVER_DRIVE_UNREAD_COUNT_INVALID

未开通会话驱动。

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

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 服务的服务购买页面开通客户端用户在线状态订阅功能。

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。

26314

SERVICE_RRSV5_UNAVAILABLE

未开通逐条消息已读功能。

排查建议：未开通逐条消息已读功能，请提交工单开启。

26315

SERVICE_RRSV5_READ_RECEIPT_NOT_SUPPORT

不支持的已读回执方式。

排查建议：协议栈参数传入有误， readType 只能传 0。

26316

SERVICE_RRSV5_PARAM_LENGTH_EXCEED

参数长度超限。

排查建议：一次调用上报已读回执的数量不能超过 100。

26317

SERVICE_RRSV5_CONVERSATION_NOT_SUPPORT

不支持的会话类型。

排查建议：该会话类型不支持，目前只支持单聊和群聊。

26318

SERVICE_RRSV5_QUERY_NOT_SUPPORT

不支持的已读查询类型。

排查建议：协议栈传的参数有误，qryType 只能传0、1、2。

26320

SERVICE_RRSV5_MESSAGE_SENDER_MISMATCH

非消息发送者。

排查建议：不是该用户发的消息，辛苦检查一下消息的发送者。

26321

SERVICE_RRSV5_MESSAGE_RECEIPT_NEEDLESS

消息为不需要回执类型。

排查建议：该消息不需要回执，下发消息的参数 needReadReceipt 需要传 1。

26322

SERVICE_RRSV5_MESSAGE_NOT_EXIST

消息不存在（私有云在用，公有云没用）

排查建议：请检查传入的 messageUID 是否正确。

26323

MSG_REACTION_LIMIT_REACHED

消息回应数量超出限制

排查建议：

含义：单条消息上的 Reaction 类型数量超过限制。

• 触发原因：给同一条消息添加一个新的 reactionId 时，系统会先看这条消息当前已有多少种不同的 reaction。如果已有 reaction 类型数已经达到应用配置上限 msgReactionCnt，再新增一种 reaction 类型就返回 26323。
• 默认上限：一条消息最多添加50个 reaction 。

26324

MSG_REACTION_USER_LIMIT_REACHED

消息回应人数超出限制

排查建议：

• 含义：某一种 Reaction 下的用户数量超过限制。
• 触发原因：给同一条消息的同一个 reactionId 添加用户时，系统会看该 reaction 下已有多少用户。如果用户数已经达到应用配置上限 msgReactionUserCnt，再有新用户添加同一个 reaction 就返回 26324。
• 默认上限：用户数上限 100。

28300

SERVICE_STT_UNAVAILABLE

语音转换服务未开启。

排查建议：需要开启语音转换服务开通服务

28304

SERVICE_STT_CONVERTED_FAILED

stt转换失败。

排查建议：语音转文字失败， 请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，时间。

28305

SERVICE_STT_INTERNAL_ERROR

语音转文本服务异常。

排查建议：语音转文字失败， 请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，时间。

28306

SERVICE_STT_PARAM_MISS

语音转文本参数缺失。

排查建议：缺少必需参数，例如：content ，消息类型 。 或者提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，时间。

28307

SERVICE_STT_USAGE_EXCEED

用量超过限制。

排查建议：开发环境免费限制 200 条，生产环境功能开通后，每月5万条限制。

28400

TRANS_SERVICE_NOT_OPEN

智能文本翻译服务未开通。

排查建议：翻译功能未开启，可在融云控制台 > 应用配置 > AI 服务 > 翻译服务 开通翻译功能。

28401

TRANS_FAILED

翻译失败。

排查建议：翻译失败，请提交工单，提供翻译相关信息与我们联系。

28402

TRANS_INTERNAL_ERROR

翻译服务内部异常。

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

28403

TRANS_PARAM_MISSING

请求翻译服务缺少必须参数。

排查建议：请参阅文本翻译，确认参数是否填写正确。

28404

TRANS_PARAM_ERROR

请求翻译服务参数不合法。

排查建议：请参阅文本翻译，确认参数是否填写正确。

28405

TRANS_QUOTA_LIMIT

使用翻译服务额度超限。

排查建议：请确认是否还有使用额度。

28406

TRANS_TEXT_LENGTH_EXCEEDS_LIMIT

翻译内容长度超限。

排查建议：请参阅文本翻译，确认请求文本内容是否超限。

28407

TRANS_LANGUAGE_NOT_SUPPORT

要翻译的目标语言不支持误。

排查建议：支持的语言详见翻译语言代码列表。

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，问题发生时间等。

30004

RC_HTTP_SEND_FAIL

导航操作时，HTTP 请求失败。

排查建议：保留字段，Web 端未使用。

30005

RC_HTTP_REQ_FAIL

请求连接导航地址失败。

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

30006

RC_HTTP_RECV_FAIL

导航操作时，HTTP 接收失败。

排查建议：保留字段，Web 端未使用。

30007

RC_NAVI_REQ_FAILED

导航返回结果异常。

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

30008

RC_NODE_NOT_FOUND

导航 HTTP 返回数据格式错误。

排查建议：保留字段，Web 端未使用。

30009

RC_DOMAIN_NOT_RESOLVE

导航数据解析后，其中不存在有效 IP 地址。

排查建议：保留字段，Web 端未使用。

30010

RC_SOCKET_NOT_CREATED

创建连接失败。

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

30011

RC_SOCKET_DISCONNECTED

链接断开。

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

30012

RC_PING_EXCEED_LIMIT

PING 失败。

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

30013

PONG_RECEIVED_ERROR

PING 超时。

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

30014

RC_MSG_SEND_FAIL

信令发送失败。

排查建议：

1. 如果是连接时出现此错误码，一般是用户网络问题导致，建议更换网络重新试一下。
2. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30015

CONNECT_OVER_FREQUENCY

连接过于频繁。

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

30016

RC_MSG_CONTENT_EXCEED_LIMIT

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

排查建议：

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

30017

MESSAGE_NOT_SUPPORT_SENDING

消息类型不支持发送。

排查建议：请确认调用 sendMessage 方法时，传入的 messageType 参数值不是 RC:StreamMsg。当前该接口不支持发送此类流式消息，请更换为其他支持的消息类型。

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 字段格式错误，正确格式：{平台类型}-{设备信息}-{sdk版本}。 其中设备信息：{手机类型}|{手机型号}|{网络类型，4G/WIFI}|{运营商标识，移动/电信/联通}。

排查建议：

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

31003

RC_CONN_SERVER_UNAVAILABLE

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

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

31004

RC_CONN_TOKEN_INCORRECT

Token 无效。

排查建议：

1. 请检查应用初始化传入的 appkey 与应用 server 获取 token 传入的 appkey 是否一致。
2. 请检查融云控制台 > 基本信息设置 token 的有效期。
3. 建议按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，重新获取一个 token 验证连接。

31005

RC_CONN_NOT_AUTHRORIZED

App 校验未通过（开通了 App 校验功能，但是校验未通过）。

排查建议：保留字段，Web 端暂未使用。

31006

RC_CONN_REDIRECTED

连接重定向。

排查建议：

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

31007

RC_CONN_PACKAGE_NAME_INVALID

包名与后台注册信息不匹配。

排查建议：保留字段，Web 端暂未使用。

31008

RC_CONN_APP_BLOCKED_OR_DELETED

App key 被封禁或已删除。

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

31009

RC_CONN_USER_BLOCKED

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

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

31010

RC_DISCONN_KICK

用户被踢下线。

排查建议：

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

31011

RC_DISCONN_EXCEPTION

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

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

31012

CONNECTION_ENCRYPT_AUTHORIZED_ERROR

链路加密认证失败。

排查建议：保留字段，Web 端暂未使用。

31020

RC_CONN_TOKEN_EXPIRED

Token 已过期。

排查建议：

1. 请检查融云控制台 > 基本信息设置 token 的有效期。
2. 建议按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，重新获取一个 token 验证连接。

31021

RC_CONN_DEVICE_ERROR

Token 中携带 Device ID 时，检测 Token 中 Device ID 与链接设备 Device ID 不一致。

排查建议：保留字段，暂时未使用。

31022

RC_CONN_HOSTNAME_ERROR

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

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

31023

RC_DISCONN_SAME_CLIENT_ON_LINE

开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线。

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

31024

RC_LISCENSE_COUNT_OUT_OF_LIMIT

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

排查建议：

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

31025

RC_CONN_WRONG_CLUSTER

客户端连错环境，引发连接拒绝；如使用开发环境 App key 连接到生产环境。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，包名信息等。

31026

RC_APP_AUTH_NOT_PASS

开启 AppServer 联合鉴权功能后，到 AppServer 认证失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，包名信息等。

31027

RC_OTP_USED

该 Token 已经被使用过，法进行连接 一次性 Token 只能连接一次，之后再使用会上报此错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，包名信息等。

31028

RC_PLATFORM_ERROR

Token 平台验证失败。

排查建议：服务端返回的链接状态值为 18，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，用户 Token 登陆平台等。

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 地址并重新连接。

32546

PROTOCOL_DECODE_ERROR

服务端解析客户端协议的密钥不正确或者 server ack code 返回不和符合预期。

排查建议：

1. 该问题只有在私有云环境会出现，与用户服务是否正确部署有关，优先联系运维确认服务部署情况
2. server ack code 范围 0-30

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，问题发生时间等。

33005

BIZ_ERROR_RECONNECT_SUCCESS

重新连接成功。

排查建议：无

33006

BIZ_ERROR_CONNECTING

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

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

33007

MSG_ROAMING_SERVICE_UNAVAILABLE

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

排查建议：

1. 请在融云控制台 IM 服务的服务购买页面检查是否已经开通单群聊消息云端存储服务。
2. 如果已经开通并且刚开通 2 个小时左右，可以卸载重装试下（更新导航信息）。

33008

MSG_INSERT_ERROR

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

排查建议：

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

33009

MSG_DEL_ERROR

聊天室被回收。

排查建议：可按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，查看聊天室信息进行确认。

33100

TAG_NOT_EXIST

标签不存在。

排查建议：

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

33101

TAG_EXISTS

标签已存在。

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

33102

NO_TAG_IN_CONVER

标签不在会话中。

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

33103

METHOD_BUSY

方法执行中，请勿重复调用。

排查建议：请稍后调用，或者在接口成功回调后再调用。

33302

SDK_PULL_CONVERSATION

SDK 拉取远端会话列表失败。

排查建议：

1. 当前 appkey 已开启了会话【自动拉取】，所以调用 getRemoteConversations 返回 33302 错误码。
2. 需要业务层自行评估是否要关闭该能力，如果要关闭，请提交工单联系我们。

33401

MODIFIED_MESSAGE_IS_NOT_SENT

被编辑消息是接收的或者没有发送成功的。

排查建议：消息编辑功能仅限用于符合以下条件的消息

1. 消息方向：必须是自己发送的消息（即 messageDirection = 1）。

2. 消息状态：必须已发送成功。

33402

MODIFIED_MESSAGE_TIMEOUT

被编辑的消息超过修改时限。

排查建议：被编辑的消息超过修改时限，检查当前时间是否超过消息发送时间 24 小时。

33403

QUOTE_MSG_NOT_FOUND

引用消息不存在。

排查建议：错误码占位，未使用

33404

INVALID_PARAMETER_QUOTE_INFO

引用信息不合法。

排查建议：

传入引用回复信息时，以下字段必须齐全且合法：

1. quoteInfo 必须是对象
2. messageUId 非空字符串
3. senderId 非空字符串
4. objectName 非空字符串
5. quoteMessageStatus 必须是 QuoteMessageStatus 枚举值

33405

REACTION_ID_INVALID

消息回应无效，ID 要求字符长度不超出 16。

排查建议：

1. 此码仅在调用表情回应接口（添加/移除/查询回应用户）时出现，属 5.42.0 以上新功能。
2. 检查 reactionId 长度与类型，确保 reactionId：
   1. 是非空字符串
   2. 长度 1~16 个字符之间
   3. 不为 undefined / null / 数字等非字符串类型
3. 注意「字符长度」的计量，校验的是字符串 length。如果用 emoji 表情符号本身作为 reactionId，需注意部分 emoji（带变体选择符、肤色修饰符、ZWJ 组合的复合 emoji）的 String.length 会远大于视觉上的 1 个字符，很容易超过 16 触发此码。建议：
   1. 用简短的标识符/编码（如 "like"、"thumbsup"、"u1F44D"）作为 reactionId，而不是直接塞复合 emoji
   2. 若必须用 emoji，先确认其 .length ≤ 16
4. removeMessageReaction 的 reactionId 必须与 addMessageReaction 时一致，否则即便长度合法也无法正确移除对应回应。

34001

RC_CONNECTION_EXIST

连接已存在。

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

34005

PACKAGE_ENVIRONMENT_ERROR

SDK 连接的环境配置不正确。

排查建议：

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 接口说明。

34009

MESSAGE_EXPANDED_ERROR

消息扩展失败。

排查建议：保留字段，暂未使用。

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

用户级别设置未开通。

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

34017

MESSAGE_INTERCEPTION_PRODUCED_NULL_MESSAGE

消息拦截器处理接口返回的消息为空。

排查建议：保留字段，暂未使用。

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\//)

34021

MESSAGE_NOT_REGISTERED

消息未被注册。

排查建议：保留字段，暂未使用。

34022

METHOD_NOT_SUPPORT

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

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

34024

ULTRA_GROUP_CHANNEL_NOT_EXIST

超级群频道不存在。

排查建议：保留字段，暂时未使用。

34025

INCONSISTENT_CONVERSATION_TYPE

扩展消息失败，因为消息中的会话类别与接口支持的会话类别不一致。

排查建议：保留字段，暂时未使用。

34200

INVALID_PARAMETER_LAUGUAGE

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

排查建议：请检查 setTranslationLanguage 接口传入的 language 参数是否正确，此参数不能为空且为字符串类型。

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 枚举。

34208

INVALID_PARAMETER_REQUEST_URL

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

排查建议：

1. 此码当前仅在国际版 SDK（nexconn-chat） 调用 downloadMedia() 时出现，且是「消息类型对、但 URL 为空」这一步失败。
2. 重点排查这条消息 content 中存放远程 URL 的字段（即 remoteFileUrlField 指向的字段）：
   1. 字段值为空字符串 "" 或只有空白字符
   2. 字段值不是字符串类型（如 null、undefined、对象）
   3. 媒体文件尚未上传完成就调用了 downloadMedia（远程 URL 还没回填）
3. 媒体消息的远程 URL 通常在文件上传成功后才回填到 content。请确保消息发送/上传成功后再调用 downloadMedia，不要在发送中或上传失败的消息上调用。
4. 若是自定义媒体消息，确认 registerMessageType 时声明的 remoteFileUrlField 字段名，与 content 中实际存放 URL 的字段名完全一致，否则会取到 undefined 而误报为空。

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 检查接口参数类型是否正确。

34223

INVALID_PARAMETER_NOTMEDIAMESSAGE

开发者 sendMediaMessage 传入的 Message.content 不是多媒体消息。

排查建议：

1. 此码当前仅在国际版 SDK（nexconn-chat） 调用 downloadMedia() 时出现。若你不是用国际版的该接口，请确认调用来源。
2. 只有「内置图片 / 文件 / GIF / 高清语音 / 小视频」或注册了 remoteFileUrlField 的自定义类型才能调用 downloadMedia。对文本、提示、普通自定义消息等非媒体类型调用，必然返回 34223。建议调用前先判断消息类型。

34224

INVALID_PARAMETER_TIMESTRING

开发者调用接口传入的时间（字符串）参数非法。可能原因：开发者调用接口传入的时间（字符串）参数类型不是字符串或者字符串为空。

排查建议：请检查接口传入的时间对象需要是非空的字符串类型。

34225

INVALID_PARAMETER_CONVERSATION

conversation 参数非法。

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

34228

INVALID_PARAMETER_NOTIFICATION_LEVEL

PushNotificationLevel 无效。

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

34229

INVALID_PARAMETER_MESSAGE_ARRAY

开发者调用接口传入的 messageIds 参数为 空或者数组长度为 0。

排查建议：请通过 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 检查接口参数类型是否正确。

34240

INVALID_CONNECT_TESTHOST_FAILED

开发者接口调用 testProxy 接口时无法联通。

排查建议：保留字段，暂未使用。

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 个字符。

34271

INVALID_PARAMETER_MESSAGE_OBJECT_NAME

参数 objectName 非法。

排查建议：保留字段，暂未使用。

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 检查接口参数类型是否正确。

34275

INVALID_PARAMETER_MESSAGE_OBJECT_NAME_LIST

参数 objectName 列表非法。

排查建议：保留字段，暂未使用。

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 类型。

34281

INVALID_MESSAGE_SENT_STATUS

SentStatus 错误。

排查建议：保留字段，暂未使用。

34282

INVALID_PARAMETER_TARGETID_LIST

参数 targetId 列表非法。

排查建议：保留字段，暂未使用。

34283

INVALID_PARAMETER_SPAN_MINUTES

参数 span minutes 非法。

排查建议：设置免打扰的 span minutes 非法，支持范围[1，1439]

34284

INVALID_PARAMETER_CONVERSATION_TYPE_LIST

参数 ConversationType 列表非法。

排查建议：

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

34287

INVALID_PARAMETER_CONVERSATION_LIST

开发者调用接口传入的 ConversationIdentifier 数组参数为空、数组长度为 0 或超过限制、包含 null 或非法对象。

排查建议：

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 仍然出现请提交工单与我们联系。

34292

READ_RECEIPT_V4_UPDATE_NOT_SUPPORT

不支持更新 v4 已读回执信息。

排查建议：保留字段，暂未使用。

34296

RC_DIRECTIONAL_MESSAGE_INVALID_CONVERSATION_TYPE

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

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

34301

RC_DB_NOT_INIT

数据库未初始化。

排查建议：保留字段，暂未使用。

34302

RC_DB_CORRUPT

数据库错误。

排查建议：保留字段，暂未使用。

34303

RC_DB_SQL_ERROR

数据库 SQL 执行异常。

排查建议：保留字段，暂未使用。

34304

RC_DB_DATA_NOT_FOUND

查询数据不存在。

排查建议：并没有查到远端的引用消息或者被引用消息，可通过获取远端历史消息确认数据是否存在。

34305

RC_NET_DATA_ERROR

网络数据解析失败。

排查建议：保留字段，暂未使用。

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 范围内。

34315

DB_UPGRADE_FAILED

数据库升级失败。

排查建议：保留字段，暂未使用。

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 类型。

34329

NET_DATA_IS_SYNCHRONIZING

数据正在同步中。

排查建议：保留字段，暂未使用。

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 必须是字符串类型。

34336

RC_REAL_TIME_CONVERSATION_UNAVAILABLE

实时会话未开启。

排查建议：该错误码一般是未开启实时会话功能，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等

34344

SERVER_DATA_ERROR

服务器数据解析失败。

排查建议：并没有查到远端的引用消息或者被引用消息，可通过获取远端历史消息确认数据是否存在。

34345

INVALID_PARAMETER_MESSAGE_INFO_MAP

参数 messageInfoMap 非法。

排查建议：需为对象，且必须包含所有 messageUIds 的键，并且每个键对应的值为非空字符串（格式：{ [引用消息UId]: 被引用原消息UId }）

34346

INVALID_PARAMETER_PAGE_TOKEN

分页游标参数错误

排查建议：

1. 此码仅在调用表情回应分页接口 getMessageReactions / getMessageReactionUsers 时出现，属 5.42.0 以上新功能。
2. pageToken 类型必须是字符串

34435

SERVER_RECORD_UNREAD_COUNT_ENABLED_FORBIDDEN

服务端记录会话未读数功能开启时禁止调用此方法。

排查建议：

1. 这是设计上的接口互斥，开通服务端记录未读数后，未读数的清除应走服务端接口 markRemoteConversationAsRead，而不是本地清理接口。
2. 接口分别有 sendSyncReadStatusMessage，clearUnreadCount，clearAllUnreadCount，clearUnreadCountByTimestamp

34436

SERVER_RECORD_UNREAD_COUNT_DISABLED

服务端记录会话未读数功能未开启。

排查建议：

1. 此码只在调用 markRemoteConversationAsRead（清除远端会话未读数）时出现。如果你在用这个接口同步多端已读状态，需要先开通对应服务端功能。
2. 可提交工单开通，若刚开通，需要清除一下 localstorage 缓存，重新连接让 SDK 拉取最新导航数据，否则缓存里的 serverSaveUnread 仍是旧值。

34439

DATABASEDISKFULL

数据库磁盘空间已满。

排查建议：

• 检查设备剩余存储空间，确认是否确实磁盘已满
• 清理设备存储（删除不需要的文件、应用缓存等）

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 检查接口参数类型是否正确。

35051

DNS_PROXY_TIMEOUT

业务域名解析监听超时

排查建议：

1. 仅出现在 Electron 私有云、且业务通过 setProxy 注册了自定义 DNS 解析代理时。
2. 核心是让 IHostResolveListener 在 2 秒内 resolve。常见超时原因：
   1. 钩子内部发起的解析请求（HTTP/DNS 查询）本身耗时过长或网络抖动
   2. 一次传入多个域名（requests 含多个 host），钩子串行解析导致累计超时 —— 应并发处理
   3. 钩子内部自己的超时设置 > 2 秒（应设得比 2 秒更短，留出余量）
   4. 钩子在某些分支下既不 resolve 也不 reject（卡死，永远等到 SDK 超时）

35052

DNS_PROXY_ERROR

业务域名解析失败

排查建议：

1. 仅出现在 Electron 私有云、且业务通过 setProxy 注册了自定义 DNS 解析代理时。若未使用该功能不应出现。
2. 重点检查 IHostResolveListener 实现，常见原因：
   - 内部发起的 DNS 解析请求（如 HTTP/UDP）网络失败、超时被 reject
   - 解析服务返回非预期结构，代码访问属性时抛 TypeError
   - 钩子内有未捕获的同步异常（如 JSON.parse 失败）
   - Promise 链中漏掉 try/catch，错误直接冒泡

35053

DNS_PROXY_DATA_ERROR

业务域名解析返回结构不可用

排查建议：

1. 此码仅出现在 Electron 私有云、且业务主动注册了自定义 DNS 解析代理的情况下。若你没有用自定义域名解析功能，不应出现此码，请优先排查是否误调用了 setProxy。
2. 确保钩子返回的是 IHostResolveResult[] 数组，且每一项严格满足：
   {
   host: string,      // 非空字符串，必须是请求中的原始域名
   ipList: string[],  // 数组，每个元素必须是合法 IPv4 或 IPv6
   source?: string    // 可选，便于日志定位
   }

35054

INVALID_DISABLE_UPDATE_LAST_MESSAGE

传入的 disableUpdateLastMessage 参数无效。在会话类型为 ULTRA GROUP 时，该字段不允许设置为 true。

排查建议：发送超级群消息时，disableUpdateLastMessage 配置参数不能为 true。

35055

ONLY_DEFAULT_CHANNEL_SUPPORTS_PINNING

超级群类型会话仅允许置顶默认频道。

排查建议：超级群类型会话仅允许置顶默认频道，即 channelId = RCDefault。

35056

SEND_READ_RECEIPT_CONF_ERROR

发送消息时配置 needReceipt 错误，相关参数仅限单群聊会话内非状态消息、非群定向消息可配置，且需要开启逐条消息已读功能。

排查建议：Web 不会返回该错误码，SDK 内部默认将 needReceipt 设置为 false。

35057

SPEECH_TO_TEXT_DISABLE

语音转文字功能未开启。

排查建议：SDK 支持将语音消息转文字功能，您可以通过融云控制台自行开启语音转文字功能。

35058

SPEECH_TO_TEXT_REQUEST_IN_PROCESS

语音转文字请求进行中，请勿重复请求。

排查建议:

1. 当针对同一资源或操作的请求已在进行中且未完成时，SDK 返回此错误以防止重复处理。
2. 建议在业务侧实现一个简单的锁机制，以确保同一资源在同一时刻只有一个请求在进行。

35059

SPEECH_TO_TEXT_MESSAGE_CONTENT_UNSUPPORTED

语音内容不可转换，参数无效。

排查建议：

1. 高清语音：
   1. remoteUrl 不能为空，且为有效的 http/https 地址
   2. numberOfChannels 为 1
   3. format 为 acc
   4. sampleRate 为 8000 或 16000
2. 普通语音：
   1. content 内容不为空

35060

TRANSLATION_PARAMS_TYPE_INVALID

翻译功能输入参数类型错误。

排查建议：请检查传入的 list 参数是否符合 TranslateMessageParam[] 接口定义，长度限制 [1, 10]。

35061

TRANSLATION_PARAMS_LIST_INVALID

翻译接口入参列表长度无效。

排查建议：翻译参数 list 数组不能为空，且 0 < list.length <= 10 。

35062

INVALID_PARAMETER_TRANSLATE_STRATEGY

会话翻译策略值无效。

排查建议：请检查传入的 strategy 参数是否符合 TranslateStrategy 枚举定义。

35063

TRANSLATION_LANGUAGE_SAME

翻译设置的源语言与目标语言一致。

排查建议：翻译的源语言和目标语言不能相同。

35064

INVALID_PARAMETER_TRANSLATE_MODE

调用翻译接口时传入的翻译模式值非法。

排查建议：请检查传入的 mode 参数是否符合 TranslateMode 枚举定义。

35065

TRANSLATION_TEXT_INVALID

调用翻译接口时，指定待翻译内容无效。

排查建议：翻译的文本内容不能为空。

35066

MSG_BLOCK_SEND

消息被拦截，不发送。

排查建议：错误码占位，目前未使用

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

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

排查建议：错误码已废弃。

39001

STREAM_MESSAGE_DISABLE

流式消息不可用。

排查建议：该错误码一般是导航没有流拉取服务地址导致，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等

39002

STREAM_MESSAGE_REQUEST_COUNT_LIMIT_EXCEEDED

流式消息并发个数限制，最多 3 个。

排查建议：客户端 SDK 允许最多同时发起 3 个流式数据请求，超出后 SDK 将返回错误码。

39003

STREAM_MESSAGE_EXPANSION_KEY_ERROR

流式消息的摘要扩展 Key 不支持修改或删除。

排查建议：messageType 为 RC:StreamMsg 的消息不支持消息扩展

39005

STREAM_MESSAGE_REQUEST_FAIL

拉取流式消息请求失败。

排查建议：

1. 所有流式请求地址打开失败，一般为网络问题，可更换网络或稍后重试。
2. 如果一直都返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等

39006

STREAM_MESSAGE_REQUEST_IN_PROCESS

消息内容正在拉取中，请勿重复请求。

排查建议：

1. 该错误码表示您尝试为同一个 msgUId 重复创建了SSE链接。系统要求每个 msgUId 在同一时间只能有一个进行中的拉取请求。
2. 建议在业务层（前端）维护一个“正在请求中的消息 msgUId列表”作为缓存。
3. 请求结束后，（无论成功或失败）都必须将该 msgUId 从缓存列表中移除，以确保后续可以重新请求。

39007

STREAM_MESSAGE_SYNCED

流式消息已同步完成，不需要重新拉取。

排查建议：

1. 出现此错误码，是因为您尝试获取一个已经拉取完毕的消息内容。
2. 在调用 requestStreamMessageContent 方法前，请先通过 msg.content.isSynced 属性判断该消息内容是否已完成拉取。

41002

QNTKN_GET_ERROR

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

排查建议：错误码已废弃。