状态码
本文档列出了 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被禁用 |