Core Error Code
融云 IM 错误码 本文件由 ErrorCodeGenerator 自动生成 请勿擅自修改
Entries
已被对方加入黑名单,消息发送失败
系统会话不支持发送该消息
appkey的数据中心与请求云控的数据中心不匹配
发送消息频率过高,1 秒钟最多只允许发送 5 条消息
操作被禁止,此错误码已被弃用
操作不支持,仅私有云有效,服务端禁用了该操作
请求超出了调用频率限制,请稍后再试
不在讨论组
发送的消息中包含敏感词 (发送方发送失败,接收方不会收到消息)
消息中敏感词已经被替换 (接收方可以收到被替换之后的消息)
超级群扩展消息,但是原始消息不存在。
超级群扩展消息,但是原始消息不支持扩展
超级群扩展消息,扩展内容格式错误
超级群扩展消息,无操作权限
不在该群组中
在群组中已被禁言。
不在该聊天室中。
聊天室禁言白名单人数超限(最多5个) 创建聊天室时,禁言白名单用户列表,支持批量设置,最多不超过 20 个
在该聊天室中已被禁言
已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。
聊天室不存在
聊天室成员超限,开发者可以提交工单申请聊天室人数限制变更。
聊天室接口参数无效。请确认参数是否为空或者有效。
聊天室云存储业务未开通
聊天室的 KV 属性个数超限,单个聊天室默认上限为 100 个
没有权限修改聊天室中已存在的属性值
超过聊天室中状态设置频率,1 个聊天室 1 秒钟最多设置和删除状态 100 次
聊天室属性自定义设置,您可以在开发者后台免费基础功能页面中开启该功能。
聊天室属性不存在
聊天室批量设置或删除KV部分不成功
聊天室批量设置或删除KV数量超限(最多一次10条)
聊天室设置 KV 失败,出现在两人或者多端同时操作一个 KV。 如果出现该错误,为避免和其他端同时操作,请延时一定时间再试
加入聊天室附加信息长度超限,默认最大长度为 128 个字符,服务可配置
没有设置该用户托管属性的权限
用户托管基本属性的key列表中没有此key
用户托管扩展属性的 key 列表中没有此 key
超过了可以设置的用户托管扩展属性的最大上限
用户托管基本属性或扩展属性的Value,字符超过最大上限
批量查询用户托管资料的数量超过了可以查询的上限 100 个
用户托管此属性 Value 只能是数字
用户托管此属性 Value 值超过设置取值范围
未开启用户信息托管功能
超级群功能未开通
超级群未知异常
非超级群成员
超级群成员禁言
超级群不存在
用户加入超级群数量超限
创建超级群频道,频道数超限
超级群频道 ID 不存在
超级群频道发送消息超限:超级群下每个频道有消息发送频率限制,默认每秒 30 条 频道内每秒发送消息总量超过限制会收到该错误码,建议延时发送或重试发送
用户不在超级群私有频道中
撤回消息参数无效,请确认撤回消息参数是否正确的填写
未开通单群聊云存储服务
IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息,IM 服务有开关,控制只可以撤回自己发送的消息,当服务该开关打开时,撤回别人的消息会报这个错误。
托管服务异常
非法操作,非群主修改群权限相关,msg中返回传的对应的key
没有权限操作
参数异常,存在长度超限
参数异常,非法字符
群组 ID 已存在
群 ID 不存在
群成员 ID 已在当前群组中
不允许通过 SDK 进行此操作
不允许任何人加入,无法加入群组
扩展信息 Key 值不存在
群主不能被踢出/退出群组
用户ID不在群组中
管理员/关注 人数超过上限
用户 ID 不在当前群管理员
无对应群 ID 和用户 ID 的邀请请求
群名称不能为空
申请进群需要等待管理员审批
群主不支持设置为管理员
邀请人进群时没有权限
邀请进群需要被邀请人同意
管理员或群主处理请求时,别的管理员已处理
老的群不支持调用托管接口,需要导入后才能调用
群ID不合法,包含特殊字符
pagetoken解析失败
已经互为好友,操作无效
待对方同意后才能加为好友
在目标用户黑名单中,不能添加好友
不在目标用户白名单中,不能添加好友
目标用户在当前用户黑名单中,不能添加好友
不在当前用户白名单中,不能添加好友
操作无效,该好友请求不存在或已经过期
当前用户好友数超出上限
目标用户好友数超出上限
非好友关系,不能执行此操作
好友自定义属性超出上限
对方设置了不允许加为好友
好友不存在
不能添加自己为好友
用户级设置服务 请求参数不合法
表示客户端版本号低,需要同步版本号,可以提交工单申请打开用户级别配置开关
用户会话标签个数超限,最多支持添加 20 个标签
未开通v4已读回执
消息 id 顺序错误
未开启在线状态订阅功能
用户被订阅量达到上限, 详细查看开发文档。
订阅用户数达到上限, 详细查看开发文档。
小视频服务未开通。可以在融云开发者后台中开启该服务。 (已经不需要开通)
上传文件超过最大限制
开启限制未传 size 参数
翻译失败,融云鉴权失败 鉴权失败或者 token 过期
翻译失败,翻译功能服务商鉴权失败 融云服务器的原因,token 无效
翻译失败,翻译功能服务商返回失败 具体服务商失败码信息
翻译失败,翻译功能未在融云开启
翻译失败,Server 没有鉴权 token 的 sercret 需要在融云开发者后台开启
短语音转录结果为空, 请核对编解码类型
语言设置错误 (语音转文字 ,目前没上线)
(MP)公众号默认已关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
(MP)公众号已关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
公众号默认已取消关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE (错误码已废弃)
(MP)公众号已经取消关注,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
(MP)未关注此公众号,针对会话类型:ConversationType_APP_PUBLIC_SERVICE
无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的) 针对会话类型:ConversationType_PUBLIC_SERVICE
公众号默认已关注,针对会话类型:ConversationType_PUBLIC_SERVICE
公众号已关注,针对会话类型:ConversationType_PUBLIC_SERVICE
公众号默认已取消关注,针对会话类型:ConversationType_PUBLIC_SERVICE (错误码已废弃)
公众号已经取消关注,针对会话类型:ConversationType_PUBLIC_SERVICE
公众号未关注,针对会话类型:ConversationType_PUBLIC_SERVICE
当前连接已经被释放
当前连接不可用
客户端发送消息请求,融云服务端响应超时
导航操作时,Http 请求失败
请求连接导航地址失败
导航操作时,HTTP 接收失败
导航返回结果异常
导航 HTTP 返回数据格式错误
导航数据解析后,其中不存在有效 IP 地址
创建连接失败
PING 失败
PING 超时
信令发送失败
连接过于频繁
消息大小超限,消息体(序列化成 json 格式之后的内容)最大 128k bytes
tcp 连接成功,rmtp 连接失败
连接ACK超时
客户端 info 字段格式错误,正确格式:{平台类型}-{设备信息}-{sdk版本}。 其中设备信息:{手机类型}|{手机型号}|{网络类型,4G/WIFI}|{运营商标识, 移动/电信/联通}
连接服务未开通,需要排查后台小程序(或桌面端)服务是否已开通
Token 无效;AppKey 和 Token 不匹配;Token 过期
App 校验未通过(开通了 App 校验功能,但是校验未通过)
连接重定向
包名与后台注册信息不匹配
AppKey 被封禁或已删除
连接失败,用户被封禁(客户端主动连接失败返回)
用户被踢下线
用户被封禁,导致 IM 连接被动断开
链路加密认证失败
Token 已过期
开启禁止把已在线客户端踢下线开关后,该错误码标识已有同类型端在线
连接总数量超过服务设定的并发限定值(私有云专属)
客户端连错环境,引发连接拒绝;如使用开发环境 Appkey 连接到生产环境
开启AppServer联合鉴权功能后,到AppServer认证失败
该 token 已经被使用过,无法进行连接 一次性 token 只能连接一次,之后再使用会上报此错误
用户已销户
私有云 License 检查不通过;APP License 过期
协议层内部错误,查询,上传,下载过程中数据错误
协议层内部错误
服务器主动断开连接(仅 quic 协议下触发)
链接被服务器中断,可能原因是运营商认为此链接非法或无效,直接断开 出现此错误码后,SDK 会自动触发重连,App 无需处理
连接被拒绝
将消息存储到本地数据时失败。 发送或插入消息时,消息需要存储到本地数据库,当存库失败时,会回调此错误码
协议栈未初始化(可能原因:1,没有调用SDK初始化接口;2,SDK的so未正常加载)
开发者接口调用时传入的参数错误
连接中,再调用 connect 被拒绝
历史消息云存储业务未开通
消息存入本地数据库失败
聊天室被回收
在数据库从解密版本升级到加密版本,第一次连接时会触发数据库的加密迁移。一般为磁盘空间不足导致,清理空间后一般可以自动恢复。
在数据库从加密版本升级到解密版本,第一次连接时会触发数据库的解密迁移。一般为磁盘空间不足导致,清理空间后一般可以自动恢复。
数据库删除失败,目前唯一可能是连接未中断,数据库还在使用中
标签不存在
连接已存在
小视频时间长度超出限制,默认小视频时长上限为 2 分钟
GIF 消息文件大小超出限制
聊天室状态未同步完成,刚加入聊天室时调用获取 KV 接口,极限情况下会存在本地数据和服务器未同步完成的情况,建议延时一段时间再获取
连接环境不正确
查询的公共服务信息不存在,请确认查询的公共服务的类型和公共服务 id 是否匹配
消息不能被扩展,只支持单群聊,其他类型消息会返回此错误,消息在发送时,Message 对象的属性 canIncludeExpansion 置为 true 才能进行扩展
消息扩展失败,一般是网络原因导致的,请确保网络状态良好,并且融云 SDK 连接正常
消息扩展大小超出限制, 默认消息扩展字典 key 长度不超过 32 个字符,value 长度不超过 4096 个字符,设置的 Expansion 键值对不超过 300 个
媒体消息媒体文件 http 上传失败
指定的会话类型不支持标签功能,会话标签仅支持单群聊会话、系统会话
标签中添加/删除的会话数量超限,最多支持添加/删除 1000 个会话
视频压缩失败
用户级别设置未开通
消息拦截器处理接口返回的消息为空
媒体文件上传异常,媒体文件不存在或文件大小为 0
上传媒体文件格式不支持
文件已过期或被清理 小视频文件默认存储 7 天,其它文件默认存储 6个月。到期后自动清理
该接口不支持超级群会话
超级群频道不存在
扩展消息失败,因为消息中的会话类别与接口支持的会话类别不一致
Http 请求报 IO 异常。通常为设备没有开启网络或者没有连接有效的网络
Http 请求报 SocketTimeoutException。网络超时
没有设置 authToken 或者 authToken 为空串
待翻译文本内容为空
app key 为空
server data invalid(注释)
连接时connection option 为空
连接使用的版本号参数错误
开发者接口调用时传入的语言非法
开发者调用的接口不支持传入的会话类型
开发者接口调用时传入的时间戳非法
开发者接口调用时传入的 uid (服务器消息唯一 id)非法
开发者接口调用时传入的 messageId 非法或者找不到对应的 Message
开发者接口调用时传入的 Message 非法,或者 MessageContent 非法
开发者接口调用时传入的 messageList 非法
开发者接口调用时传入的 mediaType 非法
开发者接口调用时传入的 requestUrl 非法
开发者接口调用时传入的 ConversationType 非法
开发者接口调用时传入的 targetId 非法
开发者调用频道相关接口时传入的 channelId 非法
开发者接口调用时传入的 tagId 非法
开发者接口调用时传入的 tagName 非法
开发者接口调用时传入的 userId 非法
开发者接口调用时传入的 userIdList 非法
开发者调用接口 setOfflineMessageDuration 传入的参数非法
开发者接口调用时传入的 HistoryMessageOption 非法
开发者接口调用时传入的 MessageExpansion 非法
开发者接口调用时传入的UltraGroupMessageExpansion keyArray 非法
开发者sendMediaMessage 传入的 Message.content 不是多媒体消息
开发者调用接口传入的时间(字符串)参数非法。可能原因:开发者调用接口传入的时间(字符串)参数类型不是字符串或者字符串为空。
RCConversationIdentifier 参数非法。 可能原因:开发者调用接口传入的 RCConversationIdentifier 参数类型不对或者参数为空
PushNotificationLevel 无效
开发者调用接口传入的 messageIds 参数为 空或者数组长度为 0
开发者调用接口传入的 ReceivedStatus 参数为 null
无效的超级群频道类型
开发者接口调用时传入的 count 非法
开发者接口调用时传入的 sendTime 非法
开发者调用接口传入的 local path 地址不存在
开发者调用接口传入的 mediaUrl 地址为空
开发者调用接口传入的 uniqueId 为空或者""
开发者调用接口传入的 MessageTag 为空 或者MessageTag.value()为空或者 ""
非法的代理配置,RongIMProxy 为空或者非法
开发者接口调用 testProxy 时传入的代理测试服务非法
开发者接口调用 testProxy 接口时无法联通
开发者接口调用recallUltraGroupMessage时,撤回了不支持的消息类型
开发者调用接口传入的 conversations 参数为 null 或者 conversations 数组包含 null 对象
开发者调用接口传入的 message 参数为空
开发者调用接口传入的 Message.SentStatus 参数为 null
设置的代理地址不可用
更新消息已读状态错误
清除消息未读状态错误
设置消息已读时间错误
获取远程推送语言错误
获取离线消息时间错误
文件保存失败
文件不存在
文件长度错误
下载链接无效
分片索引错误
上传ID无效
App Key 无效
参数 JoinMode 非法
参数 rtcRoomID 非法
参数 key 非法
参数keys 非法
参数 value 非法
参数 entries 非法
参数 notificationExtra 非法
参数 ChatRoomMemberOrder 非法
参数 TimestampOrder 非法
参数 MessageDirection 非法
参数 status 非法
参数 title 非法
参数 portrait 非法
参数 objectName 非法
参数 before 非法
参数 after 非法
参数 keyword 非法
参数 objectName 列表非法
参数 offset 非法
参数 start time 非法
参数 end time 非法
参数 limit 非法
MessageDirection错误
SentStatus错误
参数 target id 列表非法
参数 span minutes 非法
参数 ConversationType 列表非法
message handler invalid
开发者调用接口传入的 ConversationIdentifier 数组参数为空、数组长度为 0或超过限制、包含 null 或非法对象
开发者调用接口传入的 ClearMessageOption 数组参数为空、数组长度为 0或超过限制、包含 null 或非法对象
参数 startMessageUID 无效
参数 endMessageUID 无效
不支持V4已读回执功能
不支持更新v4已读回执信息
发送定向消息时,传入的会话类型不支持
多媒体上传&下载拦截器,处理接口返回的 conn 为空
数据库未初始化
数据库错误
数据库 SQL 执行异常
查询数据不存在
网络数据解析失败
订阅事件传入的订阅类型非法
订阅事件传入的订阅时长非法[60s ~ 30天]
订阅事件传入的订阅用户列表空或者数据类型非法
订阅事件传入的分页大小非法
参数 userProfile 非法
参数 userProfileVisibility 非法
参数 extra 无效
数据库升级失败
开发者接口调用时传入的 ChatRoomReceiveMessageConfig 非法
设置或获取聊天室消息级别时数量超限,最多支持 100 个
开发者接口调用时传入的参数 GroupInfo 非法
开发者接口调用时传入的参数 groupId 非法
开发者接口调用时传入的参数 groupName 非法
开发者接口调用时传入的参数 groupIds 非法
开发者接口调用时传入的参数 GroupMemberRole 非法
开发者接口调用时传入的参数 GroupApplicationStatus 非法
开发者接口调用时传入的参数 GroupApplicationDirection 非法
开发者接口调用时传入的参数 nickname 非法
开发者接口调用时传入的参数 reason 非法
开发者接口调用时传入的参数 remark 非法
开发者接口调用时传入的参数 PagingQueryOption 非法
数据正在同步中
开发者接口调用时传入的参数 QueryFriendsDirectionType 非法
开发者接口调用时传入的参数 DirectionType 非法
开发者接口调用时传入的参数 FriendApplicationType 非法
开发者接口调用时传入的参数 FriendApplicationStatus 非法
开发者接口调用时传入的参数 FriendAddPermission 非法
开发者接口调用时传入的参数 extProfile 非法
传入的 disableUpdateLastMessage 参数无效。在会话类型为 ULTRA GROUP 时,该字段不允许设置为 true
应用没有调用 connect() 方法,即调用业务。 请在连接成功后调用此方法。
IPC 进程意外终止。 如果是系统进行了资源回收后调用接口会触发此问题,SDK 会做好自动重连。 当 libRongIMLib.so 或 libsqlite.so 找不到或出现崩溃时也会触发此错误。
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.