状态码
本文档列出了 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 | 未知错误 |
| 0 | SUCCESS | 成功 |
| 2 | ACTIVE_DISCONNECT | 主动断开连接 |
| 405 | REJECTED_BY_BLACKLIST | 已被对方加入黑名单，消息发送失败 |
| 20106 | 用户已经被设置单聊禁言 | |
| 20109 | SYS_CONVERSATION_NOT_SUPPORT_MESSAGE | 系统会话不支持发送该消息 |
| 20604 | SEND_FREQUENCY_TOO_FAST | 发送消息频率过高，1 秒钟最多只允许发送 5 条消息 |
| 20605 | OPERATION_BLOCKED | 操作被禁止，此错误码已被弃用 |
| 20606 | OPERATION_NOT_SUPPORT | 操作不支持，仅私有云有效，服务端禁用了该操作 |
| 20607 | REQUEST_OVER_FREQUENCY | 请求超出了调用频率限制，请稍后再试 |
| 21406 | NOT_IN_DISCUSSION | 不在讨论组 |
| 21501 | SENSITIVE_SHIELD | 发送的消息中包含敏感词 （发送方发送失败，接收方不会收到消息） |
| 21502 | SENSITIVE_REPLACE | 消息中敏感词已经被替换 （接收方可以收到被替换之后的消息） |
| 22201 | MESSAGE_EXPAND_NOT_EXIST | 超级群扩展消息，但是原始消息不存在。 |
| 22202 | MESSAGE_EXPAND_NOT_SUPPORT | 超级群扩展消息，但是原始消息不支持扩展 |
| 22203 | MESSAGE_EXPAND_FORMAT_ERROR | 超级群扩展消息，扩展内容格式错误 |
| 22204 | MESSAGE_EXPAND_NOT_AUTHORIZED | 超级群扩展消息，无操作权限 |
| 22406 | NOT_IN_GROUP | 不在该群组中 |
| 22408 | FORBIDDEN_IN_GROUP | 在群组中已被禁言。 |
| 23406 | NOT_IN_CHATROOM | 不在该聊天室中。 |
| 23407 | GET_USERINFO_ERROR | 获取用户失败 |
| 23408 | FORBIDDEN_IN_CHATROOM | 在该聊天室中已被禁言 |
| 23409 | RC_CHATROOM_USER_KICKED | 已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。 |
| 23410 | RC_CHATROOM_NOT_EXIST | 聊天室不存在 |
| 23411 | RC_CHATROOM_IS_FULL | 聊天室成员超限，开发 者可以提交工单申请聊天室人数限制变更。 |
| 23412 | RC_CHATROOM_PATAMETER_INVALID | 聊天室接口参数无效。请确认参数是否为空或者有效。 |
| 23413 | CHATROOM_GET_HISTORYMSG_ERROR | 查询聊天室历史消息异常 |
| 23414 | CHATROOM_NOT_OPEN_HISTORYMSG_STORE | 聊天室云存储业务未开通 |
| 23423 | CHATROOM_KV_EXCEED | 聊天室的 KV 属性个数超限，单个聊天室默认上限为 100 个 |
| 23424 | CHATROOM_KV_OVERWRITE_INVALID | 没有权限修改聊天室中已存在的属性值 |
| 23425 | CHATROOM_SET_PROPERTY_OVER_FREQUENCY | 超过聊天室中状态设置频率，1 个聊天室 1 秒钟最多设置和删除状态 100 次 |
| 23426 | CHATROOM_KV_STORE_NOT_OPEN | 聊天室属性自定义设置，您可以在控制台免费基础功能页面中开启该功能。 |
| 23427 | CHATROOM_KEY_NOT_EXIST | 聊天室属性不存在 |
| 23428 | CHATROOM_KV_STORE_NOT_ALL_SUCCESS | 聊天室批量设置或删除KV部分不成功 |
| 23429 | CHATROOM_KV_STORE_OUT_LIMIT | 聊天室批量设置或删除KV数量超限（最多一次10条） |
| 23431 | CHATROOM_KV_SET_ERROR | 聊天室设置 KV 失败，出现在两人或者多端同时操作一个 KV。 如果出现该错误，为避免和其他端同时操作，请延时一定时间再试 |
| 24401 | ULTRA_GROUP_SERVICE_UNAVAILABLE | 超级群功能未开通 |
| 24402 | ULTRA_GROUP_SERVICE_ERROR | 超级群服务异常 |
| 24403 | ULTRA_GROUP_PARAMETER_ERROR | 超级群参数错误 |
| 24404 | ULTRA_GROUP_UNKNOWN_ERROR | 超级群未知异常 |
| 24406 | NOT_IN_ULTRA_GROUP | 非超级群成员 |
| 24408 | FORBIDDEN_IN_ULTRA_GROUP | 超级群成员禁言 |
| 24410 | ULTRA_GROUP_NOT_EXIST | 超级群不存在 |
| 24411 | ULTRA_GROUP_MEMBERS_OVERSIZE | 超级群成员超限制 |
| 24412 | ULTRA_GROUP_JOINED_OVERSIZE | 用户加入超级群数量超限 |
| 24413 | ULTRA_GROUP_CHANNELS_OVERSIZE | 创建超级群频道，频道数超限 |
| 24414 | ULTRA_GROUP_CHANNEL_ID_NOT_EXIST | 超级群频道 ID 不存在 |
| 24415 | ULTRA_GROUP_MESSAGE_SENT_OVER_FREQUENCY | 超级群频道发送消息超限：超级群下每个频道有消息发送频率限制，默认每秒 30 条 频道内每秒发送消息总量超过限制会收到该错误码，建议延时发送或重试发送 |
| 24416 | ULTRA_GROUP_USER_NOT_IN_PRIVATE_CHANNEL | 用户不在超级群私有频道中 |
| 25101 | RECALL_MESSAGE | 撤回消息参数无效，请确认撤回消息参数是否正确的填写 |
| 25102 | MESSAGE_STORAGE_SERVICE_UNAVAILABLE | 未开通单群聊云存储服务 |
| 25107 | RECALL_MESSAGE_USER_INVALID | IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息，IM 服务有开关，控制只可以撤回自己发送的消息，当服务该开关打开时，撤回别人的消息会报这个错误。 |
| 26001 | PUSH_PARAMETER_INVALID | 远程推送设置参数无效，请确认是否正确的填写了远程推送参数 |
| 26002 | USER_SETTING_SYNCED_ERROR | 表示客户端版本号低，需要 同步版本号，可以提交工单申请打开用户级别配置开关 |
| 26004 | CONVERSATION_TAG_OVERSIZE | 用户会话标签个数超限，最多支持添加 20 个标签 |
| 30001 | RC_NET_CHANNEL_INVALID | 当前连接已经被释放 |
| 30002 | RC_NET_UNAVAILABLE | 当前连接不可用 |
| 30003 | RC_MSG_RESP_TIMEOUT | 客户端发送消息请求，融云服务端响应超时 |
| 30004 | RC_HTTP_SEND_FAIL | 导航操作时，Http 请求失败 |
| 30005 | RC_HTTP_REQ_FAIL | 请求连接导航地址失败 |
| 30006 | RC_HTTP_RECV_FAIL | 导航操作时，HTTP 接收失败 |
| 30007 | RC_NAVI_REQ_FAILED | 导航返回结果异常 |
| 30008 | RC_NODE_NOT_FOUND | 导航 HTTP 返回数据格式错误 |
| 30009 | RC_DOMAIN_NOT_RESOLVE | 导航数据解析后，其中不存在有效 IP 地址 |
| 30010 | RC_SOCKET_NOT_CREATED | 创建连接失败 |
| 30011 | RC_SOCKET_DISCONNECTED | 链接断开 |
| 30012 | RC_PING_EXCEED_LIMIT | PING 失败 |
| 30013 | PONG_RECEIVED_ERROR | PING 超时 |
| 30014 | RC_MSG_SEND_FAIL | 信令发送失败 |
| 30015 | CONNECT_OVER_FREQUENCY | 连接过于频繁 |
| 30016 | RC_MSG_CONTENT_EXCEED_LIMIT | 消息大小超限，消息体（序列化成 json 格式之后的内容）最大 128k bytes |
| 30019 | RC_NETWORK_DOWN | 网络连接不可用 |
| 30021 | RC_TCP_DISCONNECTED_NO_RMTP | tcp 连接成功，rmtp 连接失败 |
| 31000 | RC_CONN_ACK_TIMEOUT | 连接ACK超时 |
| 31001 | RC_CONN_PROTO_VERSION_ERROR | 信令版本错误 |
| 31002 | RC_CONN_IDENTIFIER_REJECTED | 客户端 info 字段格式错误，正确格式：{平台类型}-{设备信息}-{sdk版本}。 其中设备信息：{手机类型} |
| 31003 | RC_CONN_SERVER_UNAVAILABLE | 连接服务未开通，需要排查后台小程序（或桌面端）服务是否已开通 |
| 31004 | RC_CONN_TOKEN_INCORRECT | Token 无效；AppKey 和 Token 不匹配；Token 过期 |
| 31005 | RC_CONN_NOT_AUTHRORIZED | App 校验未通过（开通了 App 校验功能，但是校验未通过） |
| 31006 | RC_CONN_REDIRECTED | 连接重定向 |
| 31007 | RC_CONN_PACKAGE_NAME_INVALID | 包名与后台注册信息不匹配 |
| 31008 | RC_CONN_APP_BLOCKED_OR_DELETED | AppKey 被封禁或已删除 |
| 31009 | RC_CONN_USER_BLOCKED | 用户被封禁 |
| 31010 | RC_DISCONN_KICK | 用户被踢下线 |
| 31011 | RC_DISCONN_EXCEPTION | 与服务器的连接已断开,用户被封禁 |
| 31012 | CONNECTION_ENCRYPT_AUTHORIZED_ERROR | 链路加密认证失败 |
| 31020 | RC_CONN_TOKEN_EXPIRED | Token 已过期 |
| 31021 | RC_CONN_DEVICE_ERROR | Token 中携带 deviceId 时，检测 Token 中deviceId 与链接设备 deviceId 不一致 |
| 31022 | RC_CONN_HOSTNAME_ERROR | 页面域名不在安全域名白名单内，需通过控制台添加安全域名配置 |
| 31023 | RC_DISCONN_SAME_CLIENT_ON_LINE | 开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线 |
| 31024 | RC_LISCENSE_COUNT_OUT_OF_LIMIT | 连接总数量超过服务设定的并发限定值（私有云专属） |
| 31025 | RC_CONN_WRONG_CLUSTER | 客户端连错环境，引发连接拒绝；如使用开发环境 Appkey 连接到生产环境 |
| 31026 | RC_APP_AUTH_NOT_PASS | 开启AppServer联合鉴权功能后，到AppServer认证失败 |
| 31027 | RC_OTP_USED | 该 token 已经被使用过,无法进行连接 一次性 token 只能连接一次，之后再使用会上报此错误 |
| 31028 | RC_PLATFORM_ERROR | Token 平台验证失败 |
| 31029 | RC_ACCOUNT_CANCELLATION | 用户已销户 |
| 31030 | RC_LICENSE_EXPIRED | 私有云 License 检查不通过;APP License 过期 |
| 32001 | RC_QUERY_ACK_NO_DATA | 协议层内部错误，查询，上传，下载过程中数据错误 |
| 32002 | RC_MSG_DATA_INCOMPLETE | 协议层内部错误 |
| 32011 | RC_UDP_DISCONNECTED | 服务器主动断开连接（仅 quic 协议下触发） |
| 32054 | RC_TCP_RESET | 链接被服务器中断，可能原因是运营商认为此链接非法或无效，直接断开 出现此错误码后，SDK 会自动触发重连，App 无需处理 |
| 32061 | CONNECTION_REFUSED | 连接被拒绝 |
| 33000 | PROTOCOL_MESSAGE_SAVED_ERROR | 将消息存储到本地数据时失败。 发送或插入消息时，消息需要存储到本地数据库，当存库失败时，会回调此错误码 |
| 33001 | BIZ_ERROR_CLIENT_NOT_INIT | 协议栈未初始化 |
| 33002 | BIZ_ERROR_DATABASE_ERROR | 数据库错误 |
| 33003 | BIZ_ERROR_INVALID_PARAMETER | 开发者接口调用时传入的参数错误 |
| 33004 | BIZ_ERROR_NO_CHANNEL | 通道无效 |
| 33005 | BIZ_ERROR_RECONNECT_SUCCESS | 重新连接成功 |
| 33006 | BIZ_ERROR_CONNECTING | 连接中，再调用 connect 被拒绝 |
| 33007 | MSG_ROAMING_SERVICE_UNAVAILABLE | 历史消息云存储业务未开通 |
| 33008 | MSG_INSERT_ERROR | 消息存入本地数据库失败 |
| 33009 | MSG_DEL_ERROR | 聊天室被回收 |
| 33100 | TAG_NOT_EXIST | 标签不存在 |
| 33101 | TAG_EXISTS | 标签已存在 |
| 33102 | NO_TAG_IN_CONVER | 标签不在会话中 |
| 34001 | RC_CONNECTION_EXIST | 连接已存在 |
| 34005 | PACKAGE_ENVIRONMENT_ERROR | 连接环境不正确 |
| 34006 | CONNECTION_TIMEOUT | 连接超时 |
| 34008 | MESSAGE_KV_NOT_SUPPORT | 消息不能被扩展，只支持单群聊，其他类型消息会返回此错误，消息在发送时，Message 对象的属性 canIncludeExpansion 置为 true 才能进行扩展 |
| 34009 | MESSAGE_EXPANDED_ERROR | 消息扩展失败，一般是网络原因导致的，请确保网络状态良好，并且融云 SDK 连接正常 |
| 34010 | EXPANSION_LIMIT_EXCEET | 消息扩展大小超出限制， 默认消息扩展字典 key 长度不超过 32 个字符，value 长度不超过 4096 个字符，设置的 Expansion 键值对不超过 300 个 |
| 34011 | UPLOAD_FAIL | 媒体消息媒体文件 http 上传失败 |
| 34013 | CONVER_OUT_LIMIT_ERROR | 标签中添加/删除的会话数量超限，最多支持添加/删除 1000 个会话 |
| 34014 | READ_RECEIPT_ERROR | 群已读回执版本不支持 |
| 34016 | PUSH_CONTENT_CONFIG_SERVICE_UNAVAILABLE | 用户级别设置未开通 |
| 34017 | MESSAGE_INTERCEPTION_PRODUCED_NULL_MESSAGE | 消息拦截器处理接口返回的消息为空 |
| 34021 | MESSAGE_NOT_REGISTERED | 消息未被注册 |
| 34022 | METHOD_NOT_SUPPORT | 该接口不支持超级群会话 |
| 34024 | ULTRA_GROUP_CHANNEL_NOT_EXIST | 超级群频道不存在 |
| 34025 | INCONSISTENT_CONVERSATION_TYPE | 扩展消息失败，因为消息中的会话类别与接口支持的会话类别不一致 |
| 34201 | CONVERSATION_TYPE_NOT_SUPPORT | 开发者调用的接口不支持传入的会话类型 |
| 34206 | MSG_LIMIT_ERROR | 开发者接口调用时传入的 messageList 非法 |
| 34238 | INVALID_PARAMETER_PROXY | 非法的代理配置，RongIMProxy 为空或者非法 |
| 34239 | INVALID_PARAMETER_TESTHOST | 开发者接口调用 testProxy 时传入的代理测试服务非法 |
| 34240 | INVALID_CONNECT_TESTHOST_FAILED | 开发者接口调用 testProxy 接口时无法联通 |
| 34245 | RC_CONN_PROXY_UNAVAILABLE | 设置的代理地址不可用 |
| 35004 | NOT_SUPPORT | 方法未支持 |
| 35005 | MAIN_PROCESS_ERROR | 主进程内方法错误 |
| 35008 | SERVER_UNAVAILABLE | 无可用的 IM 服务地址 |
| 35011 | METHOD_NOT_AVAILABLE | IM 在初次连接成功后，需立即同步消息，标记上线，然后获取全量超级群会话列表，列表同步完成前，所有超级群相关功能接口应不可用 |
| 35015 | DRAFT_SAVE_ERROR | 保存草稿失败 |
| 35016 | DRAFT_REMOVE_ERROR | 删除草稿失败 |
| 35020 | CONVER_REMOVE_ERROR | 删除会话失败 |
| 35021 | CONVER_GET_ERROR | 获取会话失败 |
| 35022 | SEARCH_PROPS_LIMIT_ERROR | 搜索字段对应消息错误 |
| -2 | UNKNOWN | 未知原因失败。 |
| -3 | PARAMETER_ERROR | 参数错误(该错误码已废弃, 请使用 ErrorCode.BIZ_ERROR_INVALID_PARAMETER ) |
| -4 | EXTRA_METHOD_UNDEFINED | 未实现的方法定义，在应用层调用 callExtra 传入无法识别的方法名时抛出(该错误已废弃, 请使用 ErrorCode.NOT_SUPPORT) |
| -6 | PARAMETER_CHANGED | 参数变更 |
| 1 | CANCEL | 己方取消已发出的通话请求 |
| 2 | REJECT | 己方拒绝收到的通话请求 |
| 3 | HANGUP | 己方挂断 |
| 4 | BUSYLINE | 己方忙碌 |
| 5 | NO_RESPONSE | 己方未接听 |
| 6 | ENGINE_UN_SUPPORTED | 己方不支持当前引擎 |
| 7 | NETWORK_ERROR | 己方网络出错 |
| 11 | REMOTE_CANCEL | 对方取消已发出的通话请求 |
| 12 | REMOTE_REJECT | 对方拒绝收到的通话请求 |
| 13 | REMOTE_HANGUP | 通话过程对方挂断 |
| 14 | REMOTE_BUSYLINE | 对方忙碌 |
| 15 | REMOTE_NO_RESPONSE | 对方未接听 |
| 16 | REMOTE_ENGINE_UN_SUPPORTED | 对方不支持当前引擎 |
| 17 | REMOTE_NETWORK_ERROR | 对方网络错误 |
| 18 | VOIP_NOT_AVALIABLE | VoIP 不可用 |
| 21407 | JOIN_IN_DISCUSSION | 加入讨论失败 |
| 21408 | CREATE_DISCUSSION | 创建讨论组失败 |
| 21409 | INVITE_DICUSSION | 设置讨论组邀请状态失败 |
| 24001 | HAVNODEVICEID | 没有注册DeviveId 也就是用户没有登陆 |
| 24002 | DEVICEIDISHAVE | 已经存在 |
| 24009 | FEILD | 没有对应的用户或token |
| 24013 | VOIPISNULL | voip为空 |
| 24010 | NOENGINETYPE | 不支持的Voip引擎 |
| 24011 | NULLCHANNELNAME | channleName 是空 |
| 24012 | VOIPDYANMICERROR | 生成Voipkey失败 |
| 24014 | NOVOIP | 没有配置voip |
| 24015 | INTERNALERRROR | 服务器内部错误 |
| 24016 | VOIPCLOSE | VOIP close |
| 35001 | GROUP_SYNC_ERROR | 群组信息异常 |
| 35002 | GROUP_MATCH_ERROR | 匹配群信息异常 |
| 35007 | CAN_NOT_RECONNECT | 已连接或者内部重连中，不允许调用重连，需先调用 disconnect 方法 |
| 35009 | HOSTNAME_ERROR | Web 端设置安全域名后，连接端域名不在安全域名范围内 |
| 35010 | HAS_OHTER_SAME_CLIENT_ON_LINE | 开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线，禁止链接 |
| 35014 | METHOD_ONLY_SUPPORT_ULTRA_GROUP | 该功能仅支持超级群(该错误码已废弃, 请使用 ErrorCode.CONVERSATION_TYPE_NOT_SUPPORT) |
| 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 | SUBSCRIBE_ERROR | 关注公众号失败 |
| 39002 | NOT_SUPPORT | 方法不支持。该错误码已在 5.8.4 版本移除，5.8.4 及之后版本对应错误码为 35004。 |
| 41001 | QNTKN_FILETYPE_ERROR | 关注公众号失败 |
| 41002 | QNTKN_GET_ERROR | 获取七牛token失败 |
| 51001 | COOKIE_ENABLE | cookie被禁用 |