Core Error Code
RongCoreClient CoreErrorCode
Entries
应用没有调用 connect() 方法,即调用业务。
参数异常。
IPC 进程意外终止。
发送消息频率过高,1 秒钟最多只允许发送 5 条消息。
操作被禁止。
操作不支持。
请求超出了调用频率限制,请稍后再试。
历史消息云存储业务未开通。
聊天室被重置
在数据库从解密版本升级到加密版本,第一次连接时会触发数据库的加密迁移。一般为磁盘空间不足导致,清理空间后一般可以自动恢复。
在数据库从加密版本升级到解密版本,第一次连接时会触发数据库的解密迁移。一般为磁盘空间不足导致,清理空间后一般可以自动恢复。
消息数据库删除失败。目前唯一可能是连接未中断,数据库还在使用中
不在该讨论组中。
发送的消息中包含敏感词 (发送方发送失败,接收方不会收到消息)
消息中敏感词已经被替换 (接收方可以收到被替换之后的消息)
超级群扩展消息,但是原始消息不存在。
超级群扩展消息,但是原始消息不支持扩展。
超级群扩展消息,扩展内容格式错误。
超级群扩展消息,无操作权限。
不在该群组中。
在群组中已被禁言。
不在该聊天室中。
在该聊天室中已被禁言
已被踢出并禁止加入聊天室。
聊天室不存在
聊天室成员超限,默认聊天室成员没有人数限制,但是开发者可以提交工单申请针对 App Key 进行聊天室人数限制, 在限制人数的情况下,调用加入聊天室的接口时人数超限,就会返回此错误码
聊天室接口参数无效。
操作跟服务端同步时出现问题,有可能是操作过于频繁所致。如果出现该错误,请延时 0.5s 再试
公众号默认已关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
公众号已关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
公众号默认已取消关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
公众号已经取消关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
未关注此公众号,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)
已被对方加入黑名单,消息发送失败。
未在对方的白名单中,消息发送失败。
连接已被释放
连接不可用
客户端发送消息请求,融云服务端响应超时。
导航 HTTP 发送失败
请求连接导航地址失败。
请求连接导航地址后,接收数据失败。
导航 HTTP 请求失败
导航 HTTP 返回数据格式错误
导航数据解析后,其中不存在有效 IP 地址。
创建 Socket 连接失败
Socket 断开
PING 失败
PING 超时
信令发送失败
连接过于频繁
消息大小超限,消息体(序列化成 json 格式之后的内容)最大 128k bytes。
tcp 连接成功,rmtp 连接失败
连接ACK超时
AppKey 错误
服务器当前不可用(预留)
Token 无效
App 校验未通过
连接重定向
ApplicationId 与后台注册信息不一致。
AppKey 被封禁或已删除
用户被封禁
用户被踢下线
与服务器的连接已断开,用户被封禁。 5.2.3新增: 5.2.3之前的版本,出现此错误也可能是用户被销户了
链路加密认证失败。
Token过期
用户在其它设备上登录
同时在线用户数超过设置上限
环境校验失败
APP 服务校验失败 连接接口 ConnectOption.connectExt 参数在 APP 服务验证不通过.
该 token 已经被使用过,无法进行连接 一次性 token 只能连接一次,之后再使用会上报此错误
设置的代理地址不可用
用户已销户
APP License 过期 请检查为您部署的 IM 服务 License 是否过期
协议层内部错误。
协议层内部错误。
连接被拒绝
链接被服务器中断,可能原因是运营商认为此链接非法或无效,直接断开 出现此错误码后,SDK 会自动触发重连,APP 侧无需处理
将消息存储到本地数据时失败。 发送或插入消息时,消息需要存储到本地数据库,当存库失败时,会回调此错误码。
SDK 没有初始化
数据库错误。
通道无效。
重新连接成功。
连接中,再调用 connect 被拒绝。
聊天室接口参数无效。
聊天室云存储业务未开通
超过聊天室的最大状态设置数,1 个聊天室默认最多设置 100 个
聊天室中非法覆盖状态值
超过聊天室中状态设置频率,1 个聊天室 1 秒钟最多设置和删除状态 100 次
聊天室状态存储功能没有开通,请联系商务开通
聊天室状态值不存在
聊天室批量设置或删除KV部分不成功
聊天室批量设置或删除KV数量超限(最多一次10条)
聊天室设置 KV 失败,出现在两人或者多端同时操作一个 KV。 如果出现该错误,为避免和其他端同时操作,请延时一定时间再试
连接已存在
聊天室状态未同步完成
撤回消息参数无效。
IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息 IM 服务有开关,控制只可以撤回自己发送的消息 当服务该开关打开时,撤回别人的消息会报这个错误 @Since 5.2.4
超级群功能未开通
超级群未知异常
非超级群成员
超级群成员禁言
超级群不存在
用户加入超级群数量超限
创建超级群频道,频道数超限
超级群 频道 ID 不存在
超级群频道发送消息超限:超级群下每个频道有消息发送频率限制,默认每秒 30 条 频道内每秒发送消息总量超过限制会收到该错误码,建议延时发送或重试发送
用户不在超级群私有频道中
远程推送设置参数无效。
远程推送设置时用户的设置信息未同步。 SDK 会自动同步设置信息,在出现此问题时请稍后再进行尝试。
用户标签个数超限,最多支持添加 20 个标签
没有开通小视频服务,请联系商务开通
标签不存在
小视频时间长度超出限制
GIF 消息文件大小超出限制
连接环境不正确(融云公有云 SDK 无法连接到私有云环境。
SDK 内部连接超时,调用 connect 接口设置有效的 timeLimit 值时会出现该错误
查询的公共服务信息不存在。
消息不能被扩展,只支持单群聊和超级群,其他类型消息会返回此错误。
消息扩展失败。
消息扩展大小超出限制, 默认消息扩展字典 key 长度不超过 32 个字符,value 长度不超过 64 个字符,设置的 Expansion 键值对不超过 300 个
媒体消息媒体文件 http 上传失败
指定的会话类型不支持标签功能,会话标签仅支持单群聊会话、系统会话
标签中添加/删除的会话数量超限,最多支持添加/删除 1000 个会话
视频压缩失败
用户级别设置未开通
消息处理接口返回的 message 为 null
媒体文件上传异常,媒体文件不存在或文件大小为 0
上传媒体文件格式不支持
文件已过期或被清理 小视频文件默认存储 7 天,其它文件默认存储 6个月。到期后自动清理。 如果小视频文件需要存储更长时间,可在
融云开发者后台](https://developer.rongcloud.cn/advance/index)的 **服务管理-> 小视频->
服务设置** 中开通小视频高级版功能,开通后小视频文件,默认存储 6 个月。
消息未被注册。
该接口不支持超级群会话
超级群频道不存在
扩展消息失败,因为消息中的会话类别与接口支持的会话类别不一致
Http 请求报 IO 异常。通常为设备没有开启网络或者没有连接有效的网络
Http 请求报 SocketTimeoutException。网络超时
无效的超级群频道类型
开发者接口调用时传入的 count 非法
开发者接口调用时传入的 sendTime 非法
翻译失败,融云鉴权失败 鉴权失败或者 token 过期
翻译失败,翻译功能服务商鉴权失败 融云服务器的原因,token 无效
翻译失败,翻译功能服务商返回失败 具体服务商失败码信息
翻译失败,翻译功能未在融云开启
翻译失败,融云限流
翻译失败,Server 没有鉴权 token 的 sercret 需要在融云开发者后台开启
短语音转录结果为空, 请核对编解码类型
没有设置 authToken 或者 authToken 为 空串
待翻译文本内容为空
app key 为空
server data invalid
描述:连接使用的版本号参数错误。
描述:开发者接口调用时传入的语言非法。
描述:开发者调用的接口不支持传入的会话类型。
描述:开发者接口调用时传入的时间戳非法。
描述:开发者接口调用时传入的 uid (服务器消息唯一 id)非法。
描述:开发者接口调用时传入的 messageId 非法或者找不到对应的 Message。
描述:开发者接口调用时传入的 Message 非法,或者 MessageContent 非法。 可能原因: 1.传入的参数 MessageContent 为 null 或者 content type 不正确; 2.传入的参数 Message 为 null 或者 class 类型不对。 3.下载或者上传媒体文件时,MessageContent 非 MediaMessageContent类型
描述:开发者接口调用时传入的 messageList 非法。
描述:开发者接口调用时传入的 mediaType 非法。 可能原因:调用媒体上传接口时,传入的参数 MediaType 不正确或者不匹配。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的 requestUrl 非法。
描述:开发者接口调用时传入的 ConversationType 非法。
描述:开发者接口调用时传入的 targetId 非法。
描述:开发者调用频道相关接口时传入的 channelId 非法。 可能原因:channelId 字符串长度不能超过 20。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的 tagId 非法。
描述:开发者接口调用时传入的 tagName 非法。 可能原因: 1.tagName 字符串长度不能超过 15; 2.不能为空。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的 userId 非法。
描述:开发者调用接口 setOfflineMessageDuration 传入的参数非法。 可能原因: 传入参数 duration 必须 >=1 && <=7
。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的 HistoryMessageOption 非法。 可能原因: HistoryMessageOption.count 为 0,或者 HistoryMessageOption 为 null。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的 MessageExpansion 非法。 可能原因: 扩展信息字典中的 Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,最大长度 32;Value 最长长度,单次设置扩展数量最大为 20,消息的扩展总数不能超过 4096。 处理建议:请检查参数是否合法。
描述:开发者接口调用时传入的UltraGroupMessageExpansion keyArray 非法。 可能原因: keyArray count 为0,或者 null。 处理建议:请检查参数是否合法。
描述:开发者sendMediaMessage 传入的 Message.content 不是多媒体消息。 可能原因:调用 sendMediaMessage 媒体消息发送接口时,传入的参数 Message 中的 Message.content 类型不对,不是多媒体消息。 处理建议:请检查参数是否合法。
描述:开发者调用接口传入的时间(字符串)参数非法。 可能原因:开发者调用接口传入的时间(字符串)参数类型不是字符串或者字符串为 null。 处理建议:请检查参数是否合法。
描述:开发者调用接口传入的 ConversationIdentifier 参数或者列表非法。 可能原因:开发者调用接口传入的 ConversationIdentifier参数类型不对或者参数为 null,ConversationIdentifier 列表为空。 处理建议:请检查参数是否合法。
描述:PushNotificationLevel 无效
描述:开发者调用接口传入的数组参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
描述:开发者调用接口传入的参数非法。
Properties
Functions
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants.