状态码
本文档列出了 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
FORBIDDEN_IN_PRIVATE
在单聊中已被禁言
20109
SYS_CONVERSATION_NOT_SUPPORT_MESSAGE
系统会话不支持发送该消息
20512
CLOUD_DATA_CENTER_INVALID
appkey 的数据中心与请求云控的数据中心不匹配
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
聊天室禁言白名单人数超限(最多5个)。创建聊天室时,禁言白名单用户列表,支持批量设置,最多不超过 20 个
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。 如果出现该错误,为避免和其他端同时操作,请延时一定时间再试
24001
HAVNODEVICEID
没有注册 DeviveId 也就是用户没有登陆
24002
DEVICEIDISHAVE
device Id 已经存在
24009
FEILD
没有对应的用户或 token
24011
NULLCHANNELNAME
channleName 是空(错误码已废弃)
24015
INTERNALERRROR
服务器内部错误
24360
RC_USER_PROFILE_KEY_NOT_ALLOW_SDK_SET
没有设置该用户托管属性的权限
24361
RC_USER_PROFILE_KEY_NOT_EXIST
用户托管基本属性的 key 列表中没有此 key
24362
RC_USER_PROFILE_EXT_KEY_NOT_EXIST
用户托管扩展属性的 key 列表中没有此 key
24363
RC_USER_PROFILE_EXT_KV_COUNT_EXCEED_LIMIT
超过了可以设置的用户托管扩展属性的最大上限
24364
RC_USER_PROFILE_VALUE_LENGTH_EXCEED_LIMIT
用户 托管基本属性或扩展属性的 Value,字符超过最大上限
24365
RC_USER_PROFILE_QUERY_COUNT_EXCEED_LIMIT
批量查询用户托管资料的数量超限
24366
RC_USER_PROFILE_USER_NOT_EXIST
没有此用户
24367
RC_USER_PROFILE_VALUE_CAN_ONLY_BE_NUMBERS
用户托管此属性 Value 只能是数字
24368
RC_USER_PROFILE_VALUE_EXCEED_RANGE
用户托管此属性 Value 值超过设置取值范围
24369
RC_USER_PROFILE_SERVICE_UNAVAILABLE
未开启用户信息托管功能
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
超级群频道发送消息超限
24416
ULTRA_GROUP_USER_NOT_IN_PRIVATE_CHANNEL
用户不在超级群私有频道中
25101
RECALL_MESSAGE
撤回消息参数无效,请确认撤回消息参数是否正确的填写
25102
MESSAGE_STORAGE_SERVICE_UNAVAILABLE
未开通单群聊云存储服务
25104
RC_SERVER_UNKOWN_ERROR
未知异常
25107
RECALL_MESSAGE_USER_INVALID
IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息,IM 服务有开关,控制只可以撤回自己发送的消息,当服务该开关打开时,撤回别人的消息会报这个错误。
25402
RC_ENTRUST_SERVER_ERROR
托管服务异常
25403
RC_ENTRUST_SERVER_PARAMETER_ERROR
托管服务参数错误
25404
RC_GROUP_ILLEGAL_ERROR
非法操作,非群主修改群权限相关,msg 中返回传的对应的 key
25405
RC_GROUP_AUTHORITY_ERROR
没有权限操作
25406
RC_GROUP_PARAMETER_LENGTH_EXCEED_LIMIT
参数异常,存在长度超限
25407
RC_GROUP_PARAMETER_FORMAT_ERROR
参数异常,非法字符
25408
RC_GROUP_PARAMETER_VALUE_CAN_ONLY_BE_NUMBERS
参数值必须是数字
25409
RC_GROUP_ID_ALREADY_EXIST
群组 ID 已存在
25410
RC_GROUP_ID_NOT_EXIST
群 ID 不存在
25411
RC_GROUP_MEMBERS_COUNT_EXCEED_LIMIT
群成员超限
25412
RC_GROUP_MEMBERS_ALREADY_IN_GROUP
群成员 ID 已在当前群组中
25413
RC_GROUP_NOT_ALLOW_SDK_OPERATION
不允许通过 SDK 进行此操作
25414
RC_GROUP_NOT_ALLOW_JOIN
不允许任何人加入,无法加入群组
25415
RC_GROUP_EXT_KEY_NOT_EXIST
扩展信息 Key 值不存在
25416
RC_GROUP_REQUEST_OVERFREQUENCY
查询频率超限
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
管理员/关注人数超过上限
25420
RC_GROUP_USER_IS_NOT_MANAGER_IN_GROUP
用户 ID 不在当前群管理员列表
25421
RC_GROUP_APPLICATION_NOT_EXIST
无对应群 ID 和用户 ID 的邀请请求
25422
RC_GROUP_QUERY_GROUP_COUNT_EXCEED_LIMIT
查询群信息个数超限
25423
RC_GROUP_NAME_INVALID
群名称不能为空
25424
RC_GROUP_JOIN_GROUP_NEED_MANAGER_ACCEPT
申请进群需要等待管理员审批
25425
RC_GROUP_OWNER_NOT_ALLOW_BE_MANAGER
群主不支持设置为管理员
25426
RC_GROUP_NO_INVITE_PERMISSION
邀请人进群时没有权限
25427
RC_GROUP_NEED_INVITEE_ACCEPT
邀请进群需要被邀请人同意
25428
RC_GROUP_APPLICATION_ALREADY_HANDLE
管理员或群主处理请求时,别的管理员已处理
25429
RC_GROUP_OLD_GROUP_NOT_ENTRUST
老的群不支持调用托管接口,需要导入后才能调用
25430
RC_GROUP_ID_INVALID
群 ID 不合法,包含特殊字符
25432
RC_PAGE_TOKEN_PARSING_FAILED
pagetoken 解析失败
25460
RC_FRIEND_ALREADY_FRIEND
已经互为好友,操作无效
25461
RC_FRIEND_NEED_ACCEPT
待对方同意后才能加为好友
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
操作无效,该好友请求不存在或已经过期
25467
RC_FRIEND_MY_FRIEND_COUNT_EXCEED_LIMIT
当前用户好友数超出上限
25468
RC_FRIEND_OTHER_FRIEND_COUNT_EXCEED_LIMIT
目标用户好友数超出上限
25469
RC_FRIEND_NOT_FRIEND
非好友关系,不能执行此操作
25470
RC_FRIEND_FIELDS_LENGTH_EXCEED_LIMIT
好友自定义属性超出上限
25471
RC_FRIEND_OTHER_NOT_ALLOW_ADD_FRIEND
对方设置了不允许加为好友
25472
RC_FRIEND_NOT_EXIST
好友不存在
25473
RC_FRIEND_NOT_ALLOW_ADD_SELF
不能添加自己为好友
26001
PUSH_PARAMETER_INVALID
用户级设置服务 请求参数不合法
26002
USER_SETTING_SYNCED_ERROR
表示客户端版本号低,需要同 步版本号,可以提交工单申请打开用户级别配置开关
26004
CONVERSATION_TAG_OVERSIZE
用户会话标签个数超限,最多支持添加 20 个标签
26005
RC_READ_RECEIPT_V4_INVALID
未开通 v4 已读回执
26006
RC_SERVER_DRIVE_UNREAD_COUNT_INVALID
未开通会话驱动
26007
RC_SERVER_PARAMETER_MESSAGEUIDS_CONFUSED
消息 id 顺序错误
26009
RC_SERVER_PARAMETER_MESSAGEUID_INVALID
消息 id 不合法
26010
RC_SERVER_PARAMETER_INVALID
参数有误
26020
RC_SUBSCRIBE_ONLINE_SERVICE_UNAVAILABLE
未开启在线状态订阅功能
26021
RC_BESUBSCRIBED_USERIDS_COUNT_EXCEED_LIMIT
用户被订阅量达到上限, 详细查看开发文档。
26022
RC_SUBSCRIBED_USERIDS_EXCEED_LIMIT
订阅用户数达到上限, 详细查看开发文档。
26106
RC_FILE_SIZE_EXCEED_LIMIT
上传文件超过最大限制
26107
INVALID_PARAMETER_SIZE_NOT_FOUND
开启限制未传 size 参数
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 字段格式错误。
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
用户被封禁,导致 IM 连接被动断开
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
将消息存储到本地数据时失败。 发送或插入消息时,消息需要存储到本地数据库,当存库失败时,会回调此错误码