状态码

SDK 状态码

-4

APP_NOT_CONNECT

应用没有调用 connect()方法，即调用业务。请在连接成功后调用此方法。

排查建议：

1. 需要在调用连接方法并返回连接成功后，再调用业务方法。类似调用加入聊天室方法之前，需要先调用融云的连接方法。

-3

OPERATION_MEDIA_NOT_FOUND

取消暂停失败。

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

-2

IPC_DISCONNECT

IPC 进程意外终止。如果是系统进行了资源回收后调用接口会触发此问题，SDK 会做好自动重连。当 libRongIMLib.so 或 libsqlite.so 找不到或出现崩溃时也会触发此错误。

排查建议：

1. Android IMLib SDK 默认是多进程模式，退到后台系统限制进程运行，可能会出现 IPC 进程被杀的情况。回到前台后，SDK 会自动重启 IPC 进程。如果您这边使用的是 5.3.0 以后的 SDK，可以改为单进程模式规避此问题。设置单进程模式可以参考文档：文档地址。
2. 也可提供用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析，日志拉取参考链接。

-1

UNKNOWN

未知错误。

排查建议：

1. 调用获取远程推送语言设置方法返回的类型错误。调用更新会话信息，已读状态等方法没有修改成功时统一的错误码。
2. 如果一直出现此问题，请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析。

0

SUCCESS

成功。

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

405

REJECTED_BY_BLACKLIST

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

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

407

NOT_IN_WHITELIST

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

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

1004

RC_SERVICE_REQUEST_UNAUTHORIZED

验证签名错误。

排查建议：请检查是否使用 Secret 算的签名，详情请参阅请求签名。

20109

RC_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 海外地址。集成客户端时，您须传入相对应的区域码，或者手动设置 SDK 连接的服务器的地址。

20604

MSG_SEND_OVERFREQUENCY

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

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

20605

RC_OPERATION_BLOCKED

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

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

20606

RC_OPERATION_NOT_SUPPORT

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

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

20607

RC_REQUEST_OVERFREQUENCY

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

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

21406

NOT_IN_DISCUSSION

不在讨论组。

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

21501

RC_MSG_BLOCKED_SENSITIVE_WORD

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

排查建议：

1. 请检查后台的敏感词配置，需通过嵌入式控制台配置。
2. 过滤方式为屏蔽消息。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

21502

RC_MSG_REPLACED_SENSITIVE_WORD

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

排查建议：

1. 请检查后台的敏感词配置，需通过嵌入式控制台配置。
2. 过滤方式为替换敏感词。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

22201

RC_ORIGINAL_MESSAGE_NOT_EXIST

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

排查建议：

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

22202

RC_ORIGINAL_MESSAGE_CANT_EXPAND

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

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

22203

RC_MESSAGE_EXPAND_FORMAT_ERROR

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

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

22204

RC_MESSAGE_EXPAND_NOT_AUTHORIZED

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

排查建议：

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

22210

RC_MESSAGE_EXPANSION_DISABLED

消息扩展功能未开启，消息不允许携带扩展或 extraContent。

排查建议：确认当前 App Key 是否已开启消息扩展功能。如需开启或仍无法使用，请提交工单与我们联系。

22406

NOT_IN_GROUP

不在该群组中。

排查建议：

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

22408

FORBIDDEN_IN_GROUP

在群组中已被禁言。

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

22412

RC_GROUP_COUNT_EXCEED_LIMIT

应用下群组总数超过限制。

排查建议：请确认当前 App Key 下的群组数量。如需调整限额，请提交工单与我们联系。

22413

RC_GROUP_JOIN_COUNT_EXCEED_LIMIT

用户加入的群组总数超过限制。

排查建议：请确认用户已加入的群组数量，可根据业务需要退出不再使用的群组。如需调整限额，请提交工单与我们联系。

23406

NOT_IN_CHATROOM

不在该聊天室中。

排查建议：

1. 聊天室具有自动销毁机制和离线成员自动退出机制，详情请参阅聊天室销毁机制和退出聊天室文档，业务层可观察一下是否因为上述机制导致。
2. 也可按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，在聊天室模块进行查询、加入等动作。
3. 如果用户在聊天室中，但服务端返回该错误，请提交工单与我们联系。

23407

GET_USER_INFO_ERROR

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

排查建议：详情请参考聊天室禁言服务。

23408

FORBIDDEN_IN_CHATROOM

在该聊天室中已被禁言。

排查建议：

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

23409

KICKED_FROM_CHATROOM

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

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

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_ILLEGAL_ARGUMENT

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

排查建议：

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

23414

ROAMING_SERVICE_UNAVAILABLE_CHATROOM

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

排查建议：可在融云控制台 IM 服务的服务购买页面开通聊天室消息云端存储服务。

23423

EXCCED_MAX_KV_SIZE

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

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

23424

TRY_OVERWRITE_INVALID_KEY

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

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

23425

EXCCED_MAX_CALL_API_SIZE

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

排查建议：该错误码服务端已废弃

23426

KV_STORE_NOT_AVAILABLE

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

排查建议：需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入 聊天室 > 聊天室属性自定义设置，开通此功能。

23427

KEY_NOT_EXIST

聊天室属性不存在。

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

23428

KV_STORE_NOT_ALL_SUCCESS

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

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

23429

KV_STORE_OUT_OF_LIMIT

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

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

23431

RC_KV_CONCURRENT_SET_ERROR

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

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

23437

RC_CHATROOM_EXTRA_SIZE_LIMIT_EXCEED

加入聊天室附加信息长度超限。

排查建议：服务端可配置，默认最大长度为 128 个字符。

23450

RC_CHATROOM_ACTIVE_COUNT_EXCEED_LIMIT

应用下存活的聊天室总数超过限制。

排查建议：请确认当前 App Key 下存活的聊天室数量，并按需销毁不再使用的聊天室。如需调整限额，请提交工单与我们联系。

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

RC_ULTRA_GROUP_DISABLED

超级群功能未开通。

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

24402

RC_ULTRA_GROUP_SERVICE_ABNORMAL

超级群服务异常。

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

24403

RC_ULTRA_GROUP_PARAMETER_ERROR

超级群参数错误。

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

24404

RC_ULTRA_GROUP_UNKNOWN_ERROR

超级群未知异常。

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

24406

RC_NOT_IN_ULTRA_GROUP

非超级群成员。

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

24408

FORBIDDEN_IN_ULTRA_GROUP

超级群成员被禁言。

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

24410

RC_ULTRA_GROUP_NOT_EXIST

超级群不存在。

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

24411

RC_ULTRA_GROUP_MEMBERS_EXCEED_LIMIT

超级群成员超限制。

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

24412

RC_ULTRA_GROUP_NUMBER_EXCEED_LIMIT

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

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

24413

RC_ULTRA_GROUP_CHANNELS_EXCEED_LIMIT

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

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

24414

RC_ULTRA_GROUP_CHANNEL_ID_NOT_EXIST

超级群频道 ID 不存在。

排查建议：

1. 业务层可按需在控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行创建超级群频道。
2. Server Api 调用详情请参考创建频道文档。

24415

RC_ULTRA_GROUP_CHANNEL_MESSAGE_EXCEED_LIMIT

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

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

24416

RC_ULTRA_GROUP_USER_NOT_IN_PRIVATE_CHANNEL

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

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

25101

RC_RECALL_PARAMETER_INVALID

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

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

25102

MESSAGE_STORAGE_SERVICE_UNAVAILABLE

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

排查建议：可在融云控制台 IM 服务的服务购买页面开通单群聊消息云端存储服务。

25104

RC_SERVER_UNKNOWN_ERROR

未知异常。

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

25107

RC_RECALL_MESSAGE_USER_INVALID

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

排查建议：

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

25402

RC_ENTRUST_SERVER_ERROR

托管服务异常。

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

25403

RC_ENTRUST_SERVER_PARAMETER_ERROR

托管服务参数错误。

排查建议：

1. 请检查用户信息托管相关接口传入参数是否符合文档要求。
2. 如有疑问，请提交工单与我们联系。

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

RC_SERVICE_INFORMATION_AUDIT_FAILED

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

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

26001

RC_PUSHSETTING_PARAMETER_INVALID

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

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

26002

RC_SETTING_SYNC_FAILED

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

排查建议：

1. 请提交工单申请打开用户级别配置开关。
2. 如果服务已开通，仍有问题，请提交工单与我们联系。

26003

RC_SERVICE_INTERNAL_ERROR

服务内部错误。

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

26004

RC_TAG_LIMIT_EXCEED

用户会话标签个数超限，最多支持添加 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 时间。

26008

RC_SERVER_PARAMETER_TIMESTAMP_NOT_SUPPORT_SYNC

上报时间不支持同步。

排查建议：消息已经过期，该时间不能超过 30 天。

26009

RC_SERVER_PARAMETER_MESSAGEUID_INVALID

消息 ID 不合法。

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

26010

RC_SERVER_PARAMETER_INVALID

参数有误。

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

26020

RC_SUBSCRIBE_ONLINE_SERVICE_UNAVAILABLE

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

排查建议：可在融云控制台 IM 服务的服务购买页面开通客户端用户在线状态订阅功能。

26021

RC_BESUBSCRIBED_USERIDS_COUNT_EXCEED_LIMIT

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

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

26022

RC_SUBSCRIBED_USERIDS_EXCEED_LIMIT

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

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

26101

RC_SIGHT_SERVICE_UNAVAILABLE

小视频服务未开通。可以在融云开发者后台中开启该服务。(已经不需要开通)

排查建议：该服务已自动开通，不需要在手动开通，如果还是出现，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID。

26106

RC_FILE_SIZE_EXCEED_LIMIT

上传文件超过最大限制。

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

26107

INVALID_PARAMETER_SIZE_NOT_FOUND

开启限制未传 size 参数。

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

26200

RC_TRANSLATION_CODE_SUCCESS

翻译成功。

排查建议：返回成功。

26201

RC_TRANSLATION_CODE_AUTH_FAILED

翻译失败，融云鉴权失败或者 token 过期。

排查建议：翻译失败，融云鉴权失败或者 token 过期，或者 token 为空，请重新获取鉴权 token。

26202

RC_TRANSLATION_CODE_SERVER_AUTH_FAILED

翻译失败，翻译功能服务商鉴权失败 融云服务器的原因，token 无效。

排查建议：翻译失败，融云鉴权失败 鉴权失败或者 token 过期，或者 token 为空，请重新获取鉴权 token。

26203

RC_TRANSLATION_CODE_TRANSLATE_FAILED

翻译失败，翻译功能服务商返回失败，具体看服务商失败码信息。

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

26204

RC_TRANSLATION_CODE_SERVICE_UNAVAILABLE

翻译失败，翻译功能未在融云开启。

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

26205

RC_TRANSLATION_CODE_CURRENT_LIMITING

翻译失败，融云限流。

排查建议：请提供 Appkey，用户 id 提交工单与我们联系。

26206

RC_TRANSLATION_CODE_SERVER_INVALID_AUTH_TOKEN

翻译失败，Server 没有鉴权 token 的 secret 需要在融云融云控制台开启。

排查建议：可在融云控制台开通智能文本翻译。

26208

RC_TRANSLATION_CODE_SERVER_INVALID_EXTRACT_RESULT

短语音转录结果为空，请核对编解码类型。

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

26209

RC_TRANSLATION_CODE_SERVER_INVALID_LANGUAGE

语言设置错误。(语音转文字，目前没上线)。

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

26210

RC_TRANSLATION_CODE_SERVER_INVALID_ENCODING_TYPE

编码格式设置错误。

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

26314

RC_SERVICE_RRSV5_UNAVAILABLE

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

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

26315

RC_SERVICE_RRSV5_READ_RECEIPT_NOT_SUPPORT

不支持的已读回执方式。

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

26316

RC_SERVICE_RRSV5_PARAM_LENGTH_EXCEED

参数长度超限。

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

26317

RC_SERVICE_RRSV5_CONVERSATION_NOT_SUPPORT

不支持的会话类型。

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

26318

RC_SERVICE_RRSV5_QUERY_NOT_SUPPORT

不支持的已读查询类型。

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

26320

RC_SERVICE_RRSV5_MESSAGE_SENDER_MISMATCH

非消息发送者。

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

26321

RC_SERVICE_RRSV5_MESSAGE_RECEIPT_NEEDLESS

消息为不需要回执类型。

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

26322

RC_SERVICE_RRSV5_MESSAGE_NOT_EXIST

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

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

26323

RC_MSG_REACTION_LIMIT_REACHED

消息回应数量超出限制

排查建议：

        1. 如果您是新增一个 reaction 类型，当前消息 reaction 数量已达上限，您可以选择已有的 reaction 进行回应。

        2. 如果您必须新增，需要先移除该消息上的某个已有 reaction，或者联系我们确认是否支持调整上限。

26324

RC_MSG_REACTION_USER_LIMIT_REACHED

消息回应人数超出限制

排查建议：

        1. 当前消息 回应人数已达上限，您可以先撤销自己之前的回应，再重新添加。

        2. 如果你们需要更高上限，可以联系我们确认是否支持调整上限。

28300

RC_SERVICE_STT_UNAVAILABLE

语音转换服务未开启。

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

28304

RC_SERVICE_STT_CONVERTED_FAILED

stt转换失败。

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

28305

RC_SERVICE_STT_INTERNAL_ERROR

语音转文本服务异常。

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

28306

RC_SERVICE_STT_PARAM_MISS

语音转文本参数缺失。

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

28307

RC_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

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

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

29002

STREAM_MESSAGE_NO_STREAM

流不存在。

排查建议：流不存在，请确认 messageUID 是否正确。

29003

STREAM_MESSAGE_DELTA_TIME_OVER

拉取超时30秒无数据结束。

排查建议：续流超时截断

29004

STREAM_MESSAGE_DELTA_TIME_LIMIT

发送流超出30分钟截断。

排查建议：请确保流在 30 分钟内发完。

29005

STREAM_MESSAGE_REVIEW_FAILED

流数据审核不过被删除。

排查建议：对审核有疑问可提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，流消息ID等。

29006

STREAM_MESSAGE_DATA_TRUNCATED

流数据大于 128k 截断。

排查建议：不支持大于 128 k 的流数据。

29007

STREAM_MESSAGE_SERVER_INTERNAL_ERROR

拉流服务内部异常。

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

29102

RC_APP_PUBLICSERVICE_DEFFOLLOWED

【已废弃】(MP)公众号默认已关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：公众号默认是关注的, 不需要再次关注。

29103

RC_APP_PUBLICSERVICE_FOLLOWED

【已废弃】(MP)公众号已关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：用户已经关注过该公众号, 不用再次关注。

29104

RC_APP_PUBLICSERVICE_DEFUNFOLLOWED

【已废弃】公众号默认已取消关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：已废弃未使用。

29105

RC_APP_PUBLICSERVICE_UNFOLLOWED

【已废弃】(MP)公众号已经取消关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：需要先关注才能发消息。

29106

RC_APP_PUBLICSERVICE_UNFOLLOW

【已废弃】(MP)未关注此公众号，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：没有关注此公众号, 所以无法取消关注。

29201

RC_PUBLICSERVICE_ERROR_TYPE

【已废弃】无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)。针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：公众号不存在，请使用正常的公众号。

29202

RC_PUBLICSERVICE_DEFFOLLOWED

【已废弃】公众号默认已关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：此公众号默认是关注的，无法取消关注。

29203

RC_PUBLICSERVICE_FOLLOWED

【已废弃】公众号已关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已废弃未使用。

29204

RC_PUBLICSERVICE_DEFUNFOLLOWED

【已废弃】公众号默认已取消关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已废弃未使用

29205

RC_PUBLICSERVICE_UNFOLLOWED

【已废弃】公众号已经取消关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已经取消关注 所以无法发消息。如需发消息，请重新关注。

29206

RC_PUBLICSERVICE_UNFOLLOW

【已废弃】公众号未关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：没有关注此公众号，所以无法取消关注。

29301

RC_SERVICE_LLM_REQUEST_FAIL

请求大模型失败。

排查建议：请求大模型失败， 请提交工单与我们联系，并附上必要的的信息，如 App key，时间。

29302

RC_SERVICE_LLM_RESPONSE_ERROR

大模型响应错误。

排查建议：大模型响应错误,建议您提交工单与我们联系，并附上必要的的信息，如 App key，时间。

29303

RC_SERVICE_LLM_RESPONSE_TIMEOUT

大模型响应超时。

排查建议：大模型响应超时,建议您提交工单与我们联系，并附上必要的的信息，如 App key，时间。

29310

RC_SERVICE_ASSISTANT_NOT_FOUND

请求中的 agentId 不存在。

排查建议：请求中的 agentId 不存在,建议您检查一下  agentId，或者提交工单与我们联系，并附上必要的的信息，如 App key，时间，agentId。

29311

RC_SERVICE_LLM_CHAT_CLIENT_NOT_FOUND

不支持的大模型服务商。

排查建议：参考模型可用的模型列表

29320

RC_SERVICE_INVALID_PARAMETER_FORMAT

请求参数的格式不对，json 反序列化失败或者空 json。

排查建议：检查请求的参数是否是 json ，或者提交工单与我们联系，并附上必要的的信息，如请求参数。

29321

RC_SERVICE_INVALID_PARAMETER_CHANNELTYPE

channelType 请求参数错误。

排查建议：channelType 该参数为空或者不等于 1。

29322

RC_SERVICE_INVALID_PARAMETER_CHANNELID

channelId 请求参数错误。

排查建议：channelId 该参数为空或者超过了 20 的长度。

29323

RC_SERVICE_INVALID_PARAMETER_TARGETID

targetId 请求参数错误。

排查建议：targetId 为空或者字符长度大于 64。

29324

RC_SERVICE_INVALID_PARAMETER_MESSAGE_USERID

message 中 userId 请求参数错误。

排查建议：message 中 userId为空,或者字符长度超过了64。

29325

RC_SERVICE_INVALID_PARAMETER_MESSAGE_MESSAGEID

message 中 messageId 请求参数错误。

排查建议：message 中 messageId 参数为空或者字符长度超过了20。格式为:XXXX-XXXX-XXXX-XXXX

29326

RC_SERVICE_INVALID_PARAMETER_MESSAGE_USERNAME

message 中 username 请求参数错误。

排查建议：message 中 username 参数为空或者字符长度超过了 64。

29327

RC_SERVICE_INVALID_PARAMETER_MESSAGE_TYPE

message 中 type 请求参数错误。

排查建议：message 中 type 参数为空或者不等于 1 ，目前  type 只支持传入 1 。

29328

RC_SERVICE_INVALID_PARAMETER_MESSAGE_CONTENT

message 中 content 请求参数错误。

排查建议：message 中 content 参数为空。

29329

RC_SERVICE_INVALID_PARAMETER_MESSAGE_TIMESTAMP

message 中 timestamp 请求参数错误。

排查建议：message 中 timestamp 参数为空, 或者不是时间戳。

29330

RC_SERVICE_INVALID_PARAMETER_AGENTID

agentId 请求参数错误。

排查建议：agentId 参数不能为空。

29331

RC_SERVICE_INVALID_PARAMETER_CUSTOMEINFO_KEY_EXCEED

customInfo 请求参数错误中 key 的数量超限。

排查建议：已经不用了。

29332

RC_SERVICE_INVALID_PARAMETER_CUSTOMEINFO_LENGTH_EXCEED

customInfo 请求参数错误中 key/value 的长度超限。

排查建议：已经不用了。

29399

RC_SERVICE_UNKOWN_ERROR

未知的错误，http 状态码会是 500未知的错误，http 状态码会是 500。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，接口地址 ，时间。

30001

RC_NET_CHANNEL_INVALID

当前连接已经被释放。

排查建议：

1. 用户可以根据连接状态监听返回的错误码判断连接异常原因。
2. 尝试更换稳定点网络重新连接，仍然出现请提交工单与我们联系。

30002

RC_NET_UNAVAILABLE

当前连接不可用。

排查建议：

1. 其他异步 api 接口需要等connect连接成功后才能调用。
2. 用户可以根据连接状态监听返回的错误码判断连接异常原因。
3. 仍然出现请提交工单与我们联系。

30003

RC_MSG_RESP_TIMEOUT

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

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

30004

RC_HTTP_SEND_FAIL

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

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

30005

RC_HTTP_REQ_TIMEOUT

请求连接导航地址失败。

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

30006

RC_HTTP_RECV_FAIL

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

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

30007

RC_NAVI_RESOURCE_ERROR

导航返回结果异常。

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

30008

RC_NODE_NOT_FOUND

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

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

30009

RC_DOMAIN_NOT_RESOLVE

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

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

30010

RC_SOCKET_NOT_CREATED

创建连接失败。

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

30011

RC_SOCKET_DISCONNECTED

链接断开。

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

30012

RC_PING_SEND_FAIL

PING 失败。

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

30013

RC_PONG_RECV_FAIL

PING 超时。

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

30014

RC_MSG_SEND_FAIL

信令发送失败。

排查建议：

1. 如果是连接时出现此错误码，一般是用户网络问题导致，建议更换网络重新试一下
2. 如果是发送媒体消息时出现此错误码，可能是上传失败 返回 error，或者上传成功，但是返回的远端地址为空，会返回次错误码，可以按照第三点，提供信息详细查询
3. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

30015

RC_CONN_OVERFREQUENCY

连接过于频繁。

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

30016

RC_MSG_SIZE_OUT_OF_LIMIT

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

排查建议：

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

30017

MESSAGE_NOT_SUPPORT_SENDING

消息类型不支持发送。

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

30019

RC_NETWORK_IS_DOWN_OR_UNREACHABLE

网络连接不可用。

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

30021

RC_TCP_DISCONNECTED_NO_RMTP

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

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

30027

CONNECTION_CLOSING

正在断开连接中。

排查建议：收到此错误可忽略，说明已有断连在进行中；可以排查下是否重复调用了 disconnect 方法。上一次断开连接操作尚未完成时又发起了新的断开请求。

31000

RC_CONN_ACK_TIMEOUT

连接 ACK 超时。

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

31001

RC_CONN_PROTO_VERSION_ERROR

信令版本错误。

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

31002

RC_CONN_ID_REJECT

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

排查建议：

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

31003

RC_CONN_SERVER_UNAVAILABLE

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

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

31004

RC_CONN_USER_OR_PASSWD_ERROR

Token 无效。

排查建议：

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

31005

RC_CONN_NOT_AUTHRORIZED

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

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

31006

RC_CONN_REDIRECTED

连接重定向。

排查建议：SDK 内部已经实现了重新连接请求导航获取 CMP 地址的逻辑，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，包名信息等。

31007

RC_CONN_PACKAGE_NAME_INVALID

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

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

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_USER_BLOCKED

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

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

31012

RC_CONN_ENCRYPT_AUTH_FAILURE

链路加密认证失败。

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

31020

RC_CONN_TOKEN_EXPIRE

Token 已过期。

排查建议：

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

31023

RC_CONN_OTHER_DEVICE_LOGIN

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

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

31024

CONCURRENT_LIMIT_ERROR

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

排查建议：

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

31025

RC_CONN_CLUSTER_ERROR

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

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

31026

RC_CONN_APP_AUTH_FAILED

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

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

31027

RC_CONN_DISPOSABLE_TOKEN_USED

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

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

31029

RC_CONN_USER_ABANDON

用户已销户。

排查建议：

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

31030

RC_CONN_APP_LICENSE_EXPIRED

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

排查建议：

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

31031

RC_AGENT_INVALID_PARAMETER_CHANNELTYPE

channelType 请求参数错误。

排查建议：检查传入的会话参数是否是单聊：Conversation.ConversationType.PRIVATE

31032

RC_AGENT_INVALID_PARAMETER_CUSTOMINFO

无效的 agent 提示词类型。

排查建议：接口传入的 customInfo 为 null 或者不是 Map 类型。

31033

RC_AGENT_SERVICE_UNAVAILABLE

Agent 服务不可用。

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

31034

RC_AGENT_INVALID_PARAMETER_MESSAGE_USERID

message 中 userId 请求参数错误。

排查建议：检查 message 对象中的 userId 字段是否为空字符串或者null。

31035

RC_AGENT_INVALID_PARAMETER_MESSAGE_MESSAGEID

message 中 messageId 请求参数错误。

排查建议：检查 message 对象中的 messageId 字段是否为空字符串或者null。

31036

RC_AGENT_INVALID_PARAMETER_MESSAGE_USERNAME

message 中 username 请求参数错误。

排查建议：检查 message 对象中的 username 字段是否为空字符串或者null。

31037

RC_AGENT_INVALID_PARAMETER_MESSAGE_TYPE

message 中 type 请求参数错误。

排查建议：检查 message 对象中的 type 字段是否为 AgentContextMessageType 枚举中定义的类型。

31038

RC_AGENT_INVALID_PARAMETER_MESSAGE_CONTENT

message 中 content 请求参数错误。

排查建议：检查 message 对象中的 content 字段是否为空字符串或者null。

31039

RC_AGENT_INVALID_PARAMETER_MESSAGE_TIMESTAMP

message 中 timestamp 请求参数错误。

排查建议：检查 message 对象中的 timestamp 字段是否为 <= 0。

31040

RC_AGENT_INVALID_PARAMETER_AGENTID

agentId 请求参数错误。

排查建议：检查接口传入的参数对象中的 agentId 字段是否为空字符串或者为null。

31041

RC_AGENT_INVALID_PARAMETER_RECOMMENDATIONPARAMS

请求 agent api 的参数 recommendationParams 类型错误。

排查建议：检查接口传入的参数 RequestRecommendationParams  是否为 null。

31042

RC_AGENT_INVALID_CONTEXT_MESSAGE_LIST

请求 agent api 的上下文消息列表类型错误。

排查建议：检查接口传入的 messages 对象是否为 Array 类型。

31043

RC_AGENT_INVALID_CONTEXT_MESSAGE

请求 agent api 的上下文消息类型错误。

排查建议：检查接口传入的 message 对象是否为 AgentContextMessage 类型。

31044

RC_AGENT_CONTEXT_MESSAGE_LIST_EXCEED_MAX

请求 agent api 的上下文消息数量超过最大值。

排查建议：接口传入的 AgentContextMessage 数组的个数大于配置的最大值 30 ，请限制传入的消息对象的数量。

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_CONNECTION_RESET_BY_PEER

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

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

32061

RC_CONN_REFUSED

连接被拒绝。

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

33000

BIZ_SAVE_MESSAGE_ERROR

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

排查建议：

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

33001

BIZ_ERROR_CLIENT_NOT_INIT

未初始化。

排查建议：请检查是否有执行 init 初始化接口。SDK的 so 库未正常加载。

33002

BIZ_ERROR_DATABASE_ERROR

数据库错误。

排查建议：

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

33003

PARAMETER_ERROR

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

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

33004

BIZ_ERROR_NO_CHANNEL

通道无效。

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

33005

BIZ_ERROR_RECONNECT_SUCCESS

重新连接成功。

排查建议：无

33006

BIZ_ERROR_CONNECTING

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

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

33007

MSG_ROAMING_SERVICE_UNAVAILABLE

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

排查建议：

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

33008

PROTOCOL_MESSAGE_INSERTED_ERROR

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

排查建议：

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

33009

RC_CHATROOM_RESET

聊天室被回收。

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

33010

DATABASE_ENCRYPT_FAILED

在数据库从解密版本升级到加密版本，第一次连接时会触发数据库的加密迁移。一般为磁盘空间不足导致，清理空间后一般可以自动恢复。

排查建议：

1. 在数据库从加密版本升级到解密版本，第一次连接时会触发数据库的解密迁移。一般为磁盘空间不足导致，清理空间后一般可以自动恢复。
2. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33011

DATABASE_DECRYPT_FAILED

在数据库从加密版本升级到解密版本，第一次连接时会触发数据库的解密迁移。一般为磁盘空间不足导致，清理空间后一般可以自动恢复。

排查建议：

1. 在数据库从加密版本升级到解密版本，第一次连接时会触发数据库的解密迁移。一般为磁盘空间不足导致，清理空间后一般可以自动恢复。
2. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33012

DATABASE_REMOVE_FAILED

数据库删除失败，目前唯一可能是连接未中断，数据库还在使用中。

排查建议：检查当前链接，确认连接成功时调用此错误码。仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

33100

RC_TAG_NOT_EXIST

标签不存在。

排查建议：

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

33101

RC_TAG_ALREADY_EXISTS

标签已存在。

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

33102

RC_TAG_INVALID_FOR_CONVERSATION

标签不在会话中。

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

33302

SDK_PULL_CONVERSATION

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

排查建议：

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

33401

RC_MODIFIED_MESSAGE_IS_NOT_SENT

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

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

33402

RC_MODIFIED_MESSAGE_TIMEOUT

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

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

33403

RC_QUOTE_MSG_NOT_FOUND

引用消息不存在。

排查建议：发送带引用/回复的消息时，被引用的消息在本地数据库中不存在。可能原因：被引用的消息已被删除、清理本地数据后引用了旧消息。可以选择发送引用消息前确认被引用消息 MessageUID
对应的消息在本地数据库中是否存在。

33405

RC_REACTION_ID_INVALID

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

排查建议：

表示回应 ID 无效，通常是 reactionId 为空、格式不合法，或长度超过 16 个字符。请检查传入的回应 ID 是否符合 SDK 约束。

34001

RC_CONNECTION_EXIST

连接已存在。

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

34002

RC_SIGHT_MSG_DURATION_LIMIT_EXCEED

小视频时间长度超出限制。

排查建议：检查小视频时间长度，时长上限不可以超过 2 分钟。

34003

RC_GIF_MSG_SIZE_LIMIT_EXCEED

GIF 消息文件大小超出限制。

排查建议：检查 GIF 图片消息的大小，限制在 2M 以内。

34004

KV_STORE_NOT_SYNC

聊天室状态未同步完成。

排查建议：

1. 刚加入聊天室时调用获取 KV 接口，极限情况下会存在本地数据和服务器未同步完成的情况，建议延时一段时间再获取。
2. 调用获取聊天室 KV 的时机不对，或者聊天室已经被回收，请在聊天室状态同步完成后调用。

34005

RC_ENVIRONMENT_ERROR

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

排查建议：

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

34006

RC_CONNECT_TIMEOUT

连接超时。

排查建议：

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

34007

RC_PUBLIC_SERVICE_PROFILE_NOT_EXIST

查询的公共服务信息不存在。

排查建议：请确保查询的公共服务的类型和公共服务 id 匹配。

34008

RC_MESSAGE_CANT_EXPAND

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

排查建议：

1. 请检查在消息发送前是否设置了消息的可扩展属性 canIncludeExpansion 为 true，详情请参阅消息扩展。
2. 消息扩展仅支持单聊、群聊、超级群会话类型，请检查是否是其他会话类型的消息。

34009

RC_MESSAGE_EXPAND_FAIL

消息扩展失败。

排查建议：请检查 SDK 是正常初始化并且是连接成功的状态，用户可在监听连接状态判断是否连接成功。

34010

RC_MSG_EXPANSION_SIZE_LIMIT_EXCEED

消息扩展大小超出限制。

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

34011

RC_FILE_UPLOAD_FAILED

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

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

34012

RC_CONVERSATION_TAG_INVALID_CONVERSATION_TYPE

指定的会话类型不支持标签功能。

排查建议：请确认会话类型是否是单聊、群聊或者是系统会话，目前标签功能只支持这三种会话类型。

34013

RC_CONVERSATION_TAG_LIMIT_EXCEED

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

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

34014

RC_GROUP_READ_RECEIPT_VERSION_NOT_SUPPORT

群已读回执版本不支持。

排查建议：检查调用的接口是否与集成的 SDK 匹配，如果是集成的 IMKit、IMLib 请参考已读回执，如果是集成的 GlobalKit，需要您开通相关功能，具体请参考文档。

34015

RC_VIDEO_COMPRESS_FAILED

视频压缩失败。

排查建议：一般为传入的视频资源本身有问题导致的，请检查下视频资源的路径是否有权限访问或者本身就是错误的无法获取到资源，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34016

RC_USER_SETTING_DISABLED

用户级别设置未开通。

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

34017

RC_MESSAGE_NULL_EXCEPTION

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

排查建议：检查下 MessageInterceptor 协议中实现的方法，排查是否有返回消息为空的情况。

34018

RC_MEDIA_EXCEPTION

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

排查建议：确认下媒体文件是否存在异常，文件信息是否为空，文件大小不能为 0。

34019

RC_MEDIA_FILE_FORMAT_NOT_SUPPORTED

上传媒体文件格式不支持。

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

34020

RC_FILE_EXPIRED

文件已过期或被清理。

排查建议：融云默认的文件服务地址，小视频文件默认存储 7 天，其它文件默认存储 6个月。到期后自动清理，请确认下这条消息是否已经过期，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34021

RC_MESSAGE_NOT_REGISTERED

消息未被注册。

排查建议：

1. 报错如果是自定义消息，自定义消息需要先进行注册，具体请参考注册自定义消息。
2. 报错如果是 SDK 内置消息，确认是否正常的初始化 SDK 并且连接成功。

34022

RC_ULTRA_GROUP_NOT_SUPPORT

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

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

34023

INVALID_PARAMETER_READ_RECEIPT_USERS_OPTION

参数 readReceiptUsersOption 为空。

排查建议：分页获取消息已读未读信息 option 查询条件为空，需要设置查询条件。

34024

RC_ULTRA_GROUP_CHANNEL_NOT_EXIST

超级群频道不存在。

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

34025

RC_MESSAGE_EXPAND_CONVERSATION_TYPE_NOT_MATCH

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

排查建议： 1、请检查 message.conversationType 的会话类型是否是单聊、群聊或者超级群会话，目前拓展消息只支持这三种会话。 2、请检查接口具体调用情况：单聊、群聊会话调用的消息拓展的相关接口在 RCCoreClient 类中，超级群调用的消息拓展的接口在 RCChannelClient 类中，并且接口名中带有 UltraGroup 字段。

34026

RC_NETWORK_THROWS_IOEXCEPTION

Http 请求报 IO 异常。通常为设备没有开启网络或者没有连接有效的网络。

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

34027

RC_NETWORK_THROWS_SOCKET_TIMEOUT_EXCEPTION

Http 请求报 SocketTimeoutException。网络超时。

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

34028

RC_NO_REDIRECT_ALLOWED

此请求不允许重定向，请使用文件真实地址。

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

34029

MESSAGE_READ_RECEIPT_NOT_SUPPORT

消息不支持发送已读回执。

排查建议：1.  消息的 needReceipt 字段不支持发送已读回执  2. 消息的发送方向不是接收的消息

34030

RC_MEDIA_DOWNLOAD_FORBIDDEN

在下载文件时遇到了 403 禁止访问的错误。

排查建议：一般是网络原因造成的，可以切换网络再下载尝试下，如果多个设备用户存在问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等

34100

RC_TRANSLATION_CODE_INVALID_AUTH_TOKEN

没有设置 authToken 或者 authToken 为空串。

排查建议：检查翻译传入的 jwtToken 此参数不能为空。

34101

RC_TRANSLATION_CODE_INVALID_TEXT

待翻译文本内容为空。

排查建议：检查调用翻译方法 translate 时，传入的待翻译文本内容参数，此参数不能为空。

34102

RC_TRANSLATION_CODE_INVALID_TARGET_LANGUAGE

目标语言为空。

排查建议：检查调用翻译方法 translate 时，传入的目标语言参数，此参数不能为空。

34103

RC_TRANSLATION_CODE_INVALID_SOURCE_LANGUAGE

源语言为空。

排查建议：检查调用翻译方法 translate 时，传入的源语言参数，此参数不能为空。

34104

RC_TRANSLATION_CODE_INVALID_SERVER_URL

翻译服务器地址为空。

排查建议：

1. 确认该 appkey 是否已经开启翻译服务，如已经开启，卸载重装试下。
2. 仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34105

RC_TRANSLATION_CODE_INVALID_APP_KEY

App key 为空。

排查建议：检查初始化 SDK init 方法传入的 appkey 参数，此值不能为空。

34106

RC_TRANSLATION_CODE_INVALID_DATA

server data invalid（注释）。

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

34129

RC_INVALID_PARAMETER_CONNECTION_OPTION_NULL

连接时connection option 为空。

排查建议：检查调用连接 connect 方法时 传入的 ConnectOption 参数，此参数不能为空

34131

RC_INVALID_PARAMETER_SDK_VERSION

连接使用的版本号参数错误。

排查建议：检查连接传入的 SDK 版本号，不可以小于3位，必须为整数，版本查看方式：studio logcat 控制台过滤 -init 重启应用会有版本号打印，您打印下版本号，提交工单与我们联系，我们根据版本确认下。

34200

RC_INVALID_PARAMETER_LANGUAGE

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

排查建议：请检查 setPushLanguageCode 或者 setPushLanguage 接口传入的 language 信息，此参数不能为空。

34201

RC_INVALID_PARAMETER_CONVERSATION_TYPE_NOT_SUPPORT

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

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

34202

RC_INVALID_PARAMETER_TIMESTAMP

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

排查建议：

1. 检查调用接口传入的时间戳是否是非法的（小于0）值；如果是调用的 “sendReadReceiptMessage，syncConversationReadStatus”方法，传入的时间戳 timestamp 不可以 <= 0。
2. 如果调用的是“getUltraGroupMessageCountByTimeRange，getMessageCountByTimeRange ”方法，startTime，endTime 不能小于0，并且startTime 必须小于 endTime。

34203

RC_INVALID_PARAMETER_MESSAGE_UID

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

排查建议：

1. 对于直接传入 messageUID 字符串对象的接口，此参数不能为空字符串。
2. 对于传入的是 Message 对象的接口，检查 message.messageUId 是否空字符串。

34204

RC_INVALID_PARAMETER_MESSAGE_ID

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

排查建议：

1. 对于直接传入 messageId 字符串对象的接口，检查该参数不能小于等于0。
2. 调用 setMessageSentStatus 方法时，Message.SentStatus 不能为空，且 message id 需要大于 0
3. 对于传入的是 Message 对象的接口，检查 message.messageId 是否大于 0。

34205

RC_INVALID_PARAMETER_MESSAGE_CONTENT

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

排查建议：

1. 检查报错接口传入的 Message 或 MessageContent 是否为空。
2. 检查报错接口传入的 Message 或 MessageContent 类型是否正确 。

34206

RC_INVALID_PARAMETER_MESSAGE_LIST

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

排查建议： 1.检查接口传入的 messageList 的内容，不能为空数组。且 Message 信息不能为空。 2.如果您是调用的删除远端消息的接口 ‘deleteRemoteMessage:’，检查下传入的 messageList 的数量是否大于 100。 3.如果调用的接口是 ‘getBatch......’ 的接口，需要检查下传入的 messages 或者 messageUIDs 数组的区间为[1，20]，所有消息的 targetId 一致且会话都为超级群会话。

34207

RC_INVALID_PARAMETER_MEDIA_TYPE

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

排查建议：下载远端资源报错，检查传入的 IRongCoreEnum.MediaType 参数，此参数不能为空。

34208

RC_INVALID_PARAMETER_REQUEST_URL

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

排查建议：检查调用判断文件是否支持断点续传时，传入的 mediaUrl 是否有值，此参数不能为空。

34209

RC_INVALID_PARAMETER_CONVERSATION_TYPE

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

排查建议：

1. 确认下传入的参数中的 conversationType 的属性，此参数不能为空。
2. 查看文档，检查调用的方法是否支持此会话类型。

34210

RC_INVALID_PARAMETER_TARGET_ID

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

排查建议：检查接口传入的 targetId 是否为空，长度是否是在区间 (0，64)之内。

34211

RC_INVALID_PARAMETER_CHANNEL_ID

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

排查建议：

1. 一般为channelid 传 null 引起，改为传空字符串。
2. 调用超级群会话频道相关接口时，传入的 channelId 需要是字符串类型，并且长度区间在[0，20)之间。
3. 如果是调用的 “searchMessagesForChannels:” 接口，检查传入的参数 “channelIds”，该参数支持一次查询多个频道，必须满足 0 < 频道个数 <= 50，如果 channelId 不合法（channelid 为 null 或长度超过  20 为不合法）或 频道个数不满足条件，errorBlock 会返回错误码此错误码。

34212

RC_INVALID_PARAMETER_TAG_ID

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

排查建议：检查调用接口传入的标签对象是否为空，是否为字符串类型，长度是否在区间(0，10)中。

34213

RC_INVALID_PARAMETER_TAG_NAME

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

排查建议：检查调用接口传入的标签名称对象是否为空，是否为字符串类型，是否长度在区间(0，15)中。

34214

RC_INVALID_PARAMETER_USER_ID

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

排查建议：检查调用接口传入的 userId 对象，此参数不能为空，长度不超过 64。

34215

RC_INVALID_PARAMETER_USERIDLIST

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

排查建议：检查调用接口传入的 userIdList 对象，此参数数组不能为空，数组内部对象个数需大于 0，数组内的每个对象的用户 Id 不能为空，并且长度在区间（0，64）中。

34218

RC_INVALID_PARAMETER_OFFLINE_DURATION

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

排查建议：检查调用 "setOfflineMessageDuration" 接口传入的 duration 参数长度在区间[1，7]中。

34219

RC_INVALID_PARAMETER_HISTORY_MESSAGE_OPTION_COUNT

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

排查建议：检查调用接口时，传入的 HistoryMessageOption 参数中，count 对象的值是否是大于 0 的。

34220

RC_INVALID_PARAMETER_MESSAGE_EXPANSION

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

排查建议： 如果是调用的更新扩展的接口，确认传入的拓展对象是否为空，此参数必须是 HashMap 类型，Map是否有内容、拓展字典中的 key value是否为字符串、key是否是大小写英文字母、数字、 特殊字符+ = - _ 的组合方式，不支持汉字。

34221

RC_INVALID_PARAMETER_ULTRA_GROUP_MESSAGE_EXPANSION_KEY_ARRAY

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

排查建议：检查调用 “removeUltraGroupMessageExpansion” 时，传入的 keyArray 对象，此参数必须为 ArrayList，且内容不能为空。

34223

RC_INVALID_PARAMETER_NOT_MEDIA_MESSAGE

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

排查建议：普通消息使用 sendMessage 接口发送，媒体消息使用 sendMediaMessage 接口发送。如果消息没有继承自 MediaMessageContent 不可以调用 sendMediaMessage 发送消息，可以通过 if (message.getContent()instanceof MediaMessageContent)来判断

34224

RC_INVALID_PARAMETER_TIME_STRING

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

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

34225

RC_INVALID_PARAMETER_CONVERSATION_IDENTIFIER

conversation 参数非法。

排查建议：检查传入的时间参数是否符合要求，此参数不能为空。

34228

RC_INVALID_PARAMETER_NOTIFICATION_LEVEL

PushNotificationLevel 无效。

排查建议：检查传入的 level 参数，传入的 level 不能为空，传入的 PushNotificationLevel 枚举值不能为 NONE。

34229

RC_INVALID_PARAMETER_MESSAGE_ARRAY

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

排查建议：检查传入的 messageIds 是否合规，不能为空且数组长度不能为 0。

34230

RC_INVALID_PARAMETER_RECEIVED_STATUS

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

排查建议：检查传入的 ReceivedStatus 参数，此参数不能为空。

34231

INVALID_PARAMETER_CHANNEL_TYPE

无效的超级群频道类型。

排查建议：检查接口调用传入的超级群频道对象 channelType 的是否合规，此参数不能为空。

34232

INVALID_PARAMETER_COUNT

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

排查建议：查看调用接口方法中对该接口传入的 count 参数的说明，传入的值需要符合对应的说明限制。

34233

INVALID_PARAMETER_SEND_TIME

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

排查建议： 检查调用接口传入的 sendTime 对象的值是否是大于等于 0 的。

34234

RC_INVALID_PARAMETER_LOCAL_PATH

开发者调用接口传入的 local path 地址不存在。

排查建议：检查传入的文件地址，文件是否存在。如果是小视频消息，确认是否有注册小视频消息类型，如果是无UI集成，需要业务侧主动注册小视频消息。

34235

RC_INVALID_PARAMETER_MEDIA_URL

开发者调用接口传入的 mediaUrl 地址为空。

排查建议：需要检查下调用接口传入的 mediaUrl 的值是否为空。

34236

RC_INVALID_PARAMETER_UNIQUE_ID

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

排查建议：检查调用接口中传入的uniqueId 是否为空或者空字符串。

34237

RC_INVALID_PARAMETER_MSG_TAG

开发者调用接口传入的 MessageTag 为空 或者MessageTag.value()为空或者空字符串。

排查建议：检查传入的 MessageTag 参数，此参数不能为空，MessageTag.value()也不能为空。

34238

INVALID_PARAMETER_PROXY

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

排查建议：调用 ”testProxy“ 接口传入的 proxy 对象需要非空，且 proxy 传入的 host 代理地址不能为空，port 代理端口需要大于0。

34239

INVALID_PARAMETER_TEST_HOST

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

排查建议：检查调用 ”testProxy“ 接口时，传入的 testHost 对象是否非空，需长度大于0。

34240

INVALID_CONNECT_TEST_HOST_FAILED

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

排查建议：

1. 确认下接口传入的地址是否有误、是否是有效的地址、已经网络连接是否正常。
2. 提供下使用的 AppKey、SDK 版本、用户 ID、问题时间，我们获取日志看下有什么线索。

34241

RC_INVALID_PARAMETER_ULTRA_GROUP_MESSAGE_OBJECT_NAME

开发者接口调用 recallUltraGroupMessage 时，撤回了不支持的消息类型。

排查建议：检查 ”recallUltraGroupMessage:“ 接口传入的撤回消息的消息类型是否为 RecallNotificationMessage；该接口不支持撤回 RecallNotificationMessage 类型的消息。

34242

RC_INVALID_PARAMETER_CONVERSATIONS

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

排查建议：检查传入的 conversations 对象，此参数不能为空。

34243

RC_INVALID_PARAMETER_MESSAGE

开发者调用接口传入的 message 参数为空。

排查建议：检查接口传入的 message 对象是否为空。

34244

RC_INVALID_PARAMETER_SENT_STATUS

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

排查建议：检查开发者调用接口传入的 Message.SentStatus 参数，此参数不能为空，并且不能为 Message.SentStatus.SENDING 状态

34245

RC_CONN_PROXY_UNAVAILABLE

设置的代理地址不可用。

排查建议：请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析。

34246

UPDATE_MESSAGE_RECEIPT_STATUS_ERROR

更新消息已读状态错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析。

34247

CLEAR_MESSAGE_UNREAD_STATUS_ERROR

清除消息未读状态错误。

排查建议：检查设置的清除消息未读状态是否正确。如果都是正确的话，请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析。

34248

SET_MESSAGE_READ_TIME_ERROR

设置消息已读时间错误。

排查建议：检查设置消息已读时间是否正确。如果都是正确的话，请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的 adb 日志进行分析。

34249

GET_PUSH_LANGUAGE_ERROR

获取远程推送语言错误。

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

34250

GET_OFFLINE_MESSAGE_DURATION_ERROR

获取离线消息时间错误。

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

34251

FILE_SAVED_FAILED

文件保存失败。

排查建议：

1. 获取给定 File 对象的父目录，检查这个父目录不存在，或者文件不存在会出现此问题。可以先检查下设备是否已经没有存储空间了。
2. 请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的 adb 日志进行分析。

34252

FILE_NOT_EXIST

文件不存在。

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

34253

FILE_SIZE_ERROR

文件长度错误。

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

34254

DOWNLOAD_URL_INVALID

下载链接无效。

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

34255

SLICE_INDEX_ERROR

分片索引错误。

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

34256

UPLOAD_ID_INVALID

上传ID无效。

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

34257

INVALID_APP_KEY

App Key 无效。

排查建议：确认是否在调用连接 IM 接口前有调用 init 接口初始化 SDK，并且传入的 App Key 参数是有效的。

34258

INVALID_PARAMETER_JOIN_MODE

参数 JoinMode 非法。

排查建议：检查 JoinMode 参数是否合法，此参数不能为空。

34259

INVALID_PARAMETER_RTCROOMID

参数 rtcRoomID 非法。

排查建议：检查调用聊天室绑定音视频房间接口 bindChatRoomWithRTCRoom 传入的 RTCRoomId 是否是字符串对象且是非空对象。

34260

INVALID_PARAMETER_KEY

参数 key 非法。

排查建议：检查调用的聊天室 KV 的相关接口（设置、删除）中，传入的参数 Key 的值是否符合：是字符串类型、长度区间在（0，128]、是否符合大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式（ "^[A-Za-z0-9+_=-]+$"）。

34261

INVALID_PARAMETER_KEYS

参数 keys 非法。

排查建议：确认聊天室 kv（ 聊天室属性集合） 以及消息扩展 kv 是否合规，集合不能为空。

34262

INVALID_PARAMETER_VALUE

参数 value 非法。

排查建议：确认传入的 value 值是否合规，聊天室 kv，value 参数不能为空，并且大小不能超过 1024 * 4。

34263

INVALID_PARAMETER_ENTRIES

参数 entries 非法。

排查建议：检查传入的 entries 参数，此参数 Map 集合不能为空。

34264

INVALID_PARAMETER_NOTIFICATION_EXTRA

参数 notificationExtra 非法。

排查建议：检查传入的 notificationExtra，此参数不能为空，并且长度不能超过 1024 * 2。

34265

INVALID_PARAMETER_CHATROOM_MEMBER_ORDER

参数 ChatRoomMemberOrder 非法。

排查建议：检查传入的 ChatRoomMemberOrder 参数，此参数不能为空。

34266

INVALID_PARAMETER_TIMESTAMP_ORDER

参数 TimestampOrder 非法。

排查建议：检查传入的 TimestampOrder 参数，此参数不能为空。

34267

INVALID_PARAMETER_MESSAGE_DIRECTION

参数 MessageDirection 非法。

排查建议：检查传入的 MessageDirection 参数，此参数不能为空。

34268

INVALID_PARAMETER_STATUS

参数 status 非法。

排查建议：检查发送超级群输入状态，状态参数不能为空。

34269

INVALID_PARAMETER_TITLE

参数 title 非法。

排查建议：检查 title 参数是否合规，传入的 title 参数不能为空。

34270

INVALID_PARAMETER_PORTRAIT

参数 portrait 非法。

排查建议：确认传入的头像信息是否为空，更新会话信息，传入的头像非法，头像不能为空。

34271

INVALID_PARAMETER_MESSAGE_OBJECT_NAME

参数 objectName 非法。

排查建议：objectName 是消息类型标识，调用需传入 objectName 的方法时，确认此参数存在并且不能为空。

34272

INVALID_PARAMETER_BEFORE

参数 before 非法。

排查建议：确认传入的 before 参数，此参数必须大于等于0。

34273

INVALID_PARAMETER_AFTER

参数 after 非法。

排查建议：确认传入的 after 参数，此参数必须大于等于0。

34274

INVALID_PARAMETER_KEYWORD

参数 keyword 非法。

排查建议：keyword 是搜索关键字，检查此关键字是否符合要求，不能为空，长度不能超过 1000。

34275

INVALID_PARAMETER_MESSAGE_OBJECT_NAME_LIST

参数 objectName 列表非法。

排查建议：objectName 是消息类型标识，调用需传入 objectName 列表的方法时，确认此参数存在并且不能为空。

34276

INVALID_PARAMETER_OFFSET

参数 offset 非法。

排查建议：确认传入的 offset 偏移量参数是否合规。要求 ≧ 0。

34277

INVALID_PARAMETER_START_TIME

参数 start time 非法。

排查建议：确认 start time 传入参数是否合规，目前搜索历史消息时用到此参数，start time 必须大于等于0，并且小于 endTime。

34278

INVALID_PARAMETER_END_TIME

参数 end time 非法。

排查建议：确认 start time 传入参数是否合规，目前搜索历史消息时用到此参数，end time 必须大于等于0。

34279

INVALID_PARAMETER_LIMIT

参数 limit 非法。

排查建议：确认 limit 参数是否合规，此参数必须大于 0。

34280

INVALID_MESSAGE_DIRECTION

MessageDirection错误。

排查建议：确认消息发送方向是否为 send，调用获取群组消息送达列表 getGroupMessageDeliverList 校验此字段，只查询本地数据库中 UID 存在且发送方向为 {@link Message.MessageDirection#SEND} 对方已经接收的消息。

34281

INVALID_MESSAGE_SENT_STATUS

SentStatus 错误。

排查建议：

1. 单聊会话只有发送状态为 RECEIVED 和 READ 的消息，才可以获取某条消息的送达时间。
2. 群聊会话只有消息发送状态为 SENT、RECEIVED 和 READ 的消息，才可以获取群组消息送达相关方法。

34282

INVALID_PARAMETER_TARGETID_LIST

参数 targetId 列表非法。

排查建议：确认传入的 target id 列表是否合规，列表不能为空，并且数组长度不能超过 20。

34283

INVALID_PARAMETER_SPAN_MINUTES

参数 span minutes 非法。

排查建议：设置的免打扰结束时间距离起始时间的间隔分钟数需要大于0 并且不能大于1440。

34284

INVALID_PARAMETER_CONVERSATION_TYPE_LIST

参数 ConversationType 列表非法。

排查建议：确认参数 ConversationType 列表 是否合规，ConversationType 列表不能为空，并且长度不能超过 300。

34285

MESSAGE_HANDLER_INVALID

message handler invalid。

排查建议：消息没有配置MessageHandler，自定义消息时，配置MessageHandler 参考 ImageMessage。如果是发送小视频消息出现此问题，确认是否已经注册小视频消息。

34287

INVALID_PARAMETER_CONVERSATION_IDENTIFIER_LIST

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

排查建议：检查传入的 ConversationIdentifier 数组参数，此数组参数不能为空，数组长度需要大于 0 并且小于等于 20、不能包含 null 或非法对象。

34288

INVALID_PARAMETER_CLEAR_MESSAGE_OPTION_LIST

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

排查建议：检查传入的 ClearMessageOption 数组参数，此数组参数不能为空，数组长度需要大于0 并且小于等于 20、不能包含 null 或非法对象。

34289

INVALID_PARAMETER_START_MESSAGE_UID

参数 startMessageUID 无效。

排查建议：检查传入的 startMessageUID 信息 不能为空，并且长度不能超过 64。

34290

INVALID_PARAMETER_END_MESSAGE_UID

参数 endMessageUID 无效。

排查建议：检查传入的 endMessageUID 信息 不能为空，并且长度不能超过 64。

34291

READ_RECEIPT_V4_NOT_SUPPORT

不支持 V4 已读回执功能。

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

34292

READ_RECEIPT_V4_UPDATE_NOT_SUPPORT

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

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

34296

RC_DIRECTIONAL_MESSAGE_INVALID_CONVERSATION_TYPE

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

排查建议：确认发送定向消息时，传入的会话类型，仅支持传入 GROUP，ULTRA_GROUP，DISCUSSION，RTC_ROOM 类型。

34300

RC_REQUEST_INTERCEPTOR_NULL_EXCEPTION

多媒体上传以及下载拦截器，处理接口返回的对象为空。

排查建议：调用 setHttpDownloadInterceptor 拦截方法中，返回的 HttpURLConnection 值不能为空。

34301

RC_DB_NOT_INIT

数据库未初始化。

排查建议：请检查 SDK 初始化以及连接是否成功，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34302

RC_DB_CORRUPT

数据库错误。

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

34303

RC_DB_SQL_ERROR

数据库 SQL 执行异常。

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

34304

RC_DB_DATA_NOT_FOUND

查询数据不存在。

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

34305

RC_NET_DATA_ERROR

网络数据解析失败。

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

34306

INVALID_PARAMETER_SUBSCRIBE_TYPE

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

排查建议：确认传入的订阅类型，SubscribeEventRequest 以及 SubscribeEventRequest.getSubscribeType()这两个参数不能为空。

34307

INVALID_PARAMETER_SUBSCRIBE_EXPIRY

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

排查建议：确认传入的时长是否合规，时常需要大于 60s，小于 2592000s。

34308

INVALID_PARAMETER_SUBSCRIBE_PUBLISHER_USERIDS

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

排查建议：确认传入的订阅用户列表是否合规，list 不能为空，并且每个用户的 userid 长度不能超过 64。

34309

INVALID_PARAMETER_SUBSCRIBE_PAGESIZE

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

排查建议：检查传入的分页大小，pageSize 需大于等于 1 并且小于等于 200。

34312

INVALID_PARAMETER_USER_PROFILE

参数 userProfile 非法。

排查建议：用户信息托管更新用户信息，传入的用户信息实体类为空，请检查传入的参数。

34313

INVALID_PARAMETER_USER_PROFILE_VISIBILITY

参数 userProfileVisibility 非法。

排查建议：更新用户信息权限时，传入的用户信息权限参数为 null，检查传入的参数。

34314

INVALID_PARAMETER_EXTRA

参数 extra 无效。

排查建议：请检查传入的 extra 参数，当 extra 不为空时长度不能超过 128。

34315

RC_DB_UPGRADE_FAILED

数据库升级失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，用户的 appkey 和 用户 id，以及时间，技术人员拉取客户端日志进行分析。或者提供下本地的adb 日志进行分析。

34316

INVALID_PARAMETER_CHATROOM_RECEIVE_MESSAGE_CONFIG

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

排查建议：检查传入的 ChatRoomReceiveMessageConfig 属性，此值不能为空。

34317

RC_EXCCED_CHATROOM_RECEIVE_MESSAGE_CONFIG_SIZE

设置或获取聊天室消息级别时数量超限，最多支持 100 个。

排查建议：检查调用获取里天使消息级别方法参数是否合规，ChatRoomReceiveMessageConfig 数组数量不能超过100个。

34318

INVALID_PARAMETER_GROUP_INFO

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

排查建议：接口传入的 GroupInfo 不能为空。

34319

INVALID_PARAMETER_GROUP_ID

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

排查建议：确认传入的 groupId 参数，此参数不能为空，且去除空格换行后长度不能为 0，长度区间为 (0，64]。

34320

INVALID_PARAMETER_GROUP_NAME

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

排查建议：检查传入的 groupName 对象，此参数不能为空，且去除空格换行后长度是否为 0、并且该对象长度区间为(0，64]。

34321

INVALID_PARAMETER_GROUP_IDS

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

排查建议：检查传入的参数 groupIds，此参数不能为空，数组的长度区间是否在 (0，20] 中，数组内 groupId 的对象是否为字符串类型、长度区间为 (0，64]。

34322

INVALID_PARAMETER_GROUP_MEMBER_ROLE

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

排查建议：检查传入的群成员身份 GroupMemberRole 对象是否在其枚举定义的范围内。

34323

INVALID_PARAMETER_GROUP_APPLICATION_STATUS

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

排查建议：检查传入的群申请状态枚举对象数组是否不为空、并且每个对象都在枚举对象 GroupApplicationStatus 的范围内。

34324

INVALID_PARAMETER_GROUP_APPLICATION_DIRECTION

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

排查建议：检查传入的群申请方向的数组对象是否不为空、并且每个对象都在枚举对象 GroupApplicationDirection 的范围内。

34325

INVALID_PARAMETER_NICK_NAME

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

排查建议：检查传入的 nickname 对象去除空格换行后长度是否为 0、并且该对象长度区间为(0，64]。

34326

INVALID_PARAMETER_REASON

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

排查建议：检查传入的 nickname 对象，此参数不能为空、去除空格换行后长度是否为 0、并且该对象长度区间为(0，128]。

34327

INVALID_PARAMETER_REMARK

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

排查建议：检查传入的 remark 对象，此参数不能为空、去除空格换行后长度是否为 0、并且该对象长度区间为(0，64]。

34328

INVALID_PARAMETER_PAGING_QUERY_OPTION

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

排查建议：接口传入的 PagingQueryOption 对象不能为空。

34329

NET_DATA_IS_SYNCHRONIZING

数据正在同步中。

排查建议：需要您根据业务层数据的实际情况，再次延时调用获取对应的内容，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

34330

INVALID_PARAMETER_QUERY_FRIENDS_DIRECTION_TYPE

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

排查建议： 检查接口传入的 QueryFriendsDirectionType 对象是否在其枚举定义范围内。

34331

INVALID_PARAMETER_DIRECTION_TYPE

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

排查建议：检查接口传入的 DirectionType 对象是否在其枚举定义范围内。

34332

INVALID_PARAMETER_FRIEND_APPLICATION_TYPE

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

排查建议：接口传入的参数需要在 RCFriendApplicationType 枚举的定义范围内。

34333

INVALID_PARAMETER_FRIEND_APPLICATION_STATUS

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

排查建议：接口传入的参数需要在 FriendApplicationStatus 枚举的定义范围内。

34334

INVALID_PARAMETER_FRIEND_ADD_PERMISSION

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

排查建议：接口传入的 FriendAddPermission 对象需要在其枚举的定义范围内。

34335

INVALID_PARAMETER_FRIEND_INFO_EXT_FIELDS

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

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

34336

RC_REAL_TIME_CONVERSATION_UNAVAILABLE

实时会话未开启。

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

34337

RC_USER_TRIGGERED_LOG_UPLOAD_DISABLED

客户主动上传日志功能未打开。

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

34338

RC_USER_TRIGGERED_LOG_UPLOAD_TIME_INTERVAL_EXCEED_LIMIT

客户主动上传日志时间间隔超出限制。

排查建议：客户主动上传日志时间间隔超出限制，SDK 侧默认最大 4 小时。

34339

RC_USER_TRIGGERED_LOG_UPLOAD_TIME_DUPLICATE

客户主动上传日志时间重复，请勿重复调用。

排查建议：客户主动上传日志时间重复，请勿重复调用（上传的时间会记录在运行内存中，如果相同的开始和结束时间上报第二次，就会报这个错，重启 app 后时间记录会失效。）

34340

RC_USER_TRIGGERED_LOG_UPLOAD_FAILED

客户主动上传日志失败。

排查建议：客户主动上传日志失败，一般是网络原因导致，可以切换网络重试。如果还有问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等

34341

INVALID_PARAMETER_PUSH_SERVER

开发者调用接口时传入的 pushServer 无效。

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

34342

INVALID_PARAMETER_STATISTIC_SERVER

开发者调用接口时传入的统计地址无效。

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

34343

INVALID_PARAMETER_PUSH_TOKEN

开发者传入的 pushToken 参数无效，iOS 端使用。

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

34344

RC_SERVER_DATA_ERROR

服务器数据解析失败。

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

34435

RC_SERVER_RECORD_UNREAD_COUNT_ENABLED_FORBIDDEN

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

排查建议：占位，未使用。

34436

RC_SERVER_RECORD_UNREAD_COUNT_DISABLED

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

排查建议：占位，未使用。

34439

DATABASEDISKFULL

数据库磁盘空间已满。

排查建议：

设备存储空间不足，导致 SDK 本地数据库无法写入。检查设备可用存储空间；检查 App 沙箱占用空间，是否有大量缓存/日志未清理。

1. 清理设备存储空间
2. 调用 SDK 提供的清理历史消息接口释放数据库空间
3. 在 App 层面监控磁盘空间，提前预警

35024

INVALID_PARAMETER_MESSAGE_TYPE

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

排查建议：有定义，未使用

35025

INVALID_PARAMETER_ORDER

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

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

35051

DNSPROXYTIMEOUT

业务域名解析监听超时

排查建议：

• 检查业务域名解析监听 setHostResolveListener 的实现，确认一定会调用回调返回结果。
• 优化业务 DNS/HTTPDNS 接口耗时，避免解析请求超过 SDK 等待时间。
• 检查客户端网络环境，确认没有弱网、代理、防火墙或 DNS 服务不可用问题。
• 避免在解析回调中执行耗时操作，建议使用缓存、快速失败或备用解析结果。
• 如果业务解析接口超时，建议业务侧增加兜底策略，例如返回缓存 IP、备用 IP，或降级关闭业务域名解析。
• 确认异步解析完成后及时调用 callback，不要只请求解析接口但未回调 SDK。

35052

DNSPROXYERROR

业务域名解析失败

排查建议：

1. 检查业务域名解析监听 setHostResolveListener 的实现，确认回调逻辑没有抛异常。

      2. 检查业务 DNS/HTTPDNS 服务是否可用，确认接口能正常返回解析结果。

      3. 检查客户端当前网络是否正常，是否存在 DNS、代理、防火墙、证书或网关限制。

      4. 在业务解析回调中增加异常捕获，避免异常直接抛出到 SDK。

      5. 确认解析成功后调用回调返回结果，不要遗漏异步回调。

      6. 如果业务解析服务失败，建议业务侧增加兜底策略，例如返回系统 DNS 解析结果、备用 IP，或临时关闭业务域名解析。

35053

DNSPROXYDATASTRUCTUREERROR

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

排查建议：

1. 检查业务域名解析回调的返回数据，确保每个请求域名都有对应解析结果。

      2. 确保返回的 host 与 SDK 请求的 host 完全一致。

      3. 确保返回的 ipList 不为空。

      4. 确保 ipList 中只包含合法 IPv4 或 IPv6 地址，不要返回域名、完整 URL 或带端口的地址。

      5. 检查业务 DNS/HTTPDNS 服务是否返回异常、空数据或格式错误数据。

      6. 如果暂时不需要自定义业务域名解析，可关闭业务域名解析监听，恢复 SDK 默认 DNS 解析逻辑。

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 错误，相关参数仅限单群聊会话内非状态消息、非群定向消息可配置，且需要开启逐条消息已读功能。

排查建议：

   1.  发送消息时配置 needReceipt 错误，相关参数仅限单群聊会话内非状态消息、非群定向消息可配置。

   2. 需要开启逐条消息已读功能。

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

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

排查建议：调用 translateMessagesWithParams 方法传入的 TranslateMessagesParams 参数为 null，或者消息参数列表 params.getList() 是null。

35061

TRANSLATION_PARAMS_LIST_INVALID

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

排查建议：翻译参数 list 数组不能为空，且不能超过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

消息被拦截，不发送。

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

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 不支持修改或删除。

排查建议：ObjectName 为 RC:StreamMsg 的 RCStreamMessage 类型的消息不支持消息扩展功能

39004

STREAM_MESSAGE_REQUEST_RESET

拉取流式消息时被重置。

排查建议：服务单判断流式消息拉取乱序，需要重新拉取。

39005

STREAM_MESSAGE_REQUEST_FAIL

拉取流式消息请求失败。

排查建议：

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

39006

STREAM_MESSAGE_REQUEST_IN_PROCESS

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

排查建议：

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

39007

STREAM_MESSAGE_SYNCED

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

排查建议：

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