跳到主要内容

状态码

SDK 状态码​

状态码说明
-1000开发者接口调用时传入的参数错误。
-1未知状态，具体请【 提交工单 】。
-3取消或暂停下载媒体文件失败。失败的原因一般为下载任务已经结束，或媒体消息不存在。
0连接成功。
1当前设备网络不可用。
2当前设备切换到飞行模式。
3当前设备切换到 2G（GPRS、EDGE）低速网络。
4当前设备切换到 3G 或 4G 高速网s络。
5当前设备切换到 WIFI 网络。
6当前用户在其他设备上登录，此设备被踢下线。
7当前用户在 Web 端登录。
8服务器异常。
9连接验证异常。
10连接中。
11连接失败或未连接。
12当前用户已注销。
405已被对方加入黑名单，消息发送失败。
407未在对方的白名单中，消息发送失败。
5004超时。
20106该用户处于单聊禁言状态，禁止发送单聊消息。
20604发送消息频率过高，1 秒钟最多只允许发送 5 条消息，详细请联系商务，电话：13161856839。
20605信令被封禁。如遇到该错误，请提交工单。
20607调用超过频率限制，请稍后再试。
22201消息扩展/修改，但是原始消息不存在。
22202消息扩展/修改，但是原始消息不支持扩展。
22203消息扩展/修改，扩展内容格式错误。
22204消息扩展/修改，无操作权限。
22406当前用户不在群组中。
22408当前用户在群组中已被禁言。
23406当前用户不在聊天室中。
23408当前用户在聊天室中已被禁言。
23409当前用户已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。
23410聊天室不存在。
23411聊天室成员超限，开发者可以提交工单申请聊天室人数限制变更。
23412聊天室接口参数不正确。
23414聊天室云存储业务未开通，如需开通请提交工单。
23423聊天室的属性个数超限，单个聊天室默认上限为 100 个。
23424没有权限修改聊天室中已存在的属性值。
23425聊天室中属性设置频率超限，单个聊天室每秒上限 100 次。
23426未开通聊天室属性自定义设置。请在控制台免费基础功能页面开通聊天室属性自定义设置。
23427聊天室属性值不存在。
23431多端操作聊天室同一属性时属性设置失败。
24401超级群功能没有开通。
24402超级群服务异常。
24403超级群参数错误。
24404超级群未知异常。
24406当前用户不在超级群中。
24408当前用户在超级群中已被禁言。
24410超级群不存在。
24411超级群成员超限制。
24412用户加入超级群数量超限。
24413创建超级群频道，频道数超限。
24414超级群频道 ID 不存在。
24416用户不在超级群私有频道成员列表中
25101撤回参数不正确。
25102未开通历史消息云存储。请开通单群聊消息云端存储或聊天室消息云端存储服务。
25103清除历史消息时，传递的时间戳大于当前系统时间。
26001Push 参数不正确。
25105清除历史消息时遇到内部异常，请提交工单确认原因。
25107撤回他人消息失败。服务端可控制消息是否可由他人（非发送者本人）撤回。如果服务端已设置为仅限发送者本人撤回，则在撤回他人消息时报这个错误。
26002向服务端同步时出现问题，有可能是操作过于频繁所致。请稍后再试。
26101没有在控制台开启小视频服务。
30001连接已被释放。
30002当前连接不可用。
30002连接不可用。
30003客户端发送消息请求，融云服务端响应超时。
30004导航 HTTP 发送失败。
30007导航 HTTP 请求失败。
30008导航 HTTP 返回数据格式错误。
30010创建 Socket 连接失败。
30011Socket 断开。
30012PING 失败。
30013PING 超时。
30014信令发送失败。
30015连接过于频繁。
30016消息大小超限，消息体最大 128 KB。
31000连接 ACK 超时。
31002初始化时填写的 AppKey 不正确，请在 控制台获取。
31003服务器当前不可用。在小程序端或桌面端未开通对应服务时也会返回该错误。
31004Token 无效。
31005App 校验未通过（开通了 App 校验功能，但是校验未通过）。
31007BundleID 不正确。
31008AppKey 被封禁或已删除。
31009连接失败，一般因为用户已被封禁。
31010当前用户在其他移动设备上登录，此设备被踢下线。
31011用户在线时被封禁导致连接断开。
31020Token过期。一般是因为在控制台设置了token 过期时间，需要请求您的服务器重新获取 Token 并再次用新的 Token 建立连接。
31023重连过程中当前用户在其它设备上登录。
31028配置了 SDK 通过代理连接融云，但代理地址不可用。
32054TCP 连接被重置，可能原因是运营商认为此链接非法或无效。SDK 会自动触发重连，App 侧无需处理。
32061连接被拒绝。SDK 会自动重连，开发者无须处理。
33000将消息存储到本地数据时失败。发送或插入消息时，消息需要存储到本地数据库，当存库失败时，会回调此错误码。
33001未调用 SDK 的初始化方法。
33002数据库错误。
33003调用接口时传入的参数不正确。
33007未开通历史消息云存储服务。可以在 基础功能中开启服务。
34001连接已存在，或正在重连中。
34002小视频时间长度超出限制，默认小视频时长上限为 2 分钟。
34003GIF 消息文件大小超出限制， 默认 GIF 文件大小上限是 2 MB。
34004聊天室状态未同步完成，加入聊天室时立即调用获取聊天室属性接口，极限情况下会存在本地数据和服务器未同步完成的情况，开发者可以设置聊天室属性回调，SDK 同步完成时会在属性回调中通知开发者，开发者可根据回调状态进行获取。
34005连接环境不正确。
34006连接超时。当调用 connectWithToken:timeLimit:dbOpened:success:error: 接口，timeLimit 为有效值时，SDK 在 timeLimit 时间内还没连接成功返回此错误。
34007查询的公共服务信息不存在。
34008消息不能被扩展。消息在发送时，RCMessage 对象的属性 canIncludeExpansion 置为 YES 才能进行扩展。
34009消息扩展失败。一般是网络原因导致的，请确保网络状态良好，并且融云 SDK 连接正常。
34010消息扩展大小超出限制， 默认消息扩展字典 key 长度不超过 32 个字符，value 长度不超过 4096 个字符（ SDK < 5.2.0 时，value 长度限制最大 64 个字符），设置的 Expansion 键值对不超过 300 个。
34011媒体消息的媒体文件 http 上传失败。
34012指定的会话类型不支持标签功能，会话标签仅支持单群聊会话、系统会话。
34013批量处理指定标签的会话个数超限，批量处理会话个数最大为 1000。
34015视频消息压缩失败。
34016用户级别设置未开通。
34017消息处理失败。一般是消息为 nil。
34018媒体文件上传异常，媒体文件不存在或文件大小为 0。
34019上传媒体文件格式不支持。
34020文件已过期或被清理。如果 App Key 使用 IM 旗舰版或 IM 尊享版，文件存储时长默认为 180 天（不含小视频文件，小视频文件存储 7 天）。注意，IM 商用版（已下线）默认存储 7 天。如需了解IM 旗舰版或 IM 尊享版的具体功能与费用，请参见融云官方价格说明页面及计费说明。
34021消息未注册。发送或者插入自定义消息之前，请确保注册了该类型的消息。
34022该接口不支持超级群会话。
34023超级群功能未开通。
34024超级群频道不存在。
34210传入的 targetId 非法。
34211传入的 channelId 非法。
34212传入的 tagId 非法。
34213传入的 tagName 非法。
34214传入的 userId 非法。
34215传入的 userIdList 非法。
34238非法的代理配置。请检查代理是否为空或者是否传入了非法参数。
34239传入的代理测试服务非法。
34240代理地址或 testHost 地址无法连通。
34241超级群撤回了不支持的消息类型，请开发者判断当前 RCMessageContent 类型是否支持被撤。
40006RTC 房间操作时传入参数错误。
24360没有设置该用户托管属性的权限。
24361用户托管基本属性的 key 列表中没有此 key。
24362用户托管扩展属性的 key 列表中没有此 key。
24363超过了可以设置的用户托管扩展属性的最大上限。
24364用户托管基本属性或扩展属性的 Value 字符超过最大上限。
24365批量查询用户托管资料的数量超过了可以查询的上限 100 个。
24366没有此用户。
24367用户托管此属性 Value 只能是数字。
24368用户托管此属性 Value 值超过设置取值范围。
24369未开启用户信息托管功能。
25402托管服务异常。
25403托管服务参数错误。
25404非法操作，非群主修改群权限相关。
25405没有权限操作调用的功能。
25406参数异常，存在长度超限。
25407参数异常，非法字符。
25408参数值必须是数字。
25409群组 ID 已存在。
25410群 ID 不存在。
25411群成员超限。
25412群成员 ID 已在当前群组中。
25413不允许通过 SDK 进行此操作。
25414不允许任何人加入，无法加入群组。
25415扩展信息 Key 值不存在。
25416查询频率超限。
25417群主不能被踢出/退出群组。
25418用户 ID 不在群组中。
25419管理员/关注人数超过上限。
25420用户 ID 不在当前群管理员。
25421无对应群 ID 和用户 ID 的邀请请求。
25422查询群信息个数超限。
25423群名称不能为空。
25424申请进群需要等待管理员审批。
25425群主不支持设置为管理员。
25426邀请人进群时没有权限。
25427邀请进群需要被邀请人同意。
25428管理员或群主处理请求时，别的管理员已处理。
25429老的群不支持调用托管接口，需要导入后才能调用。
25430群 ID 不合法，包含特殊字符。
25432pagetoken 解析失败。
25460已经互为好友，操作无效。
25461待对方同意后才能加为好友。
25462在目标用户黑名单中，不能添加好友。
25463不在目标用户白名单中，不能添加好友。
25464目标用户在当前用户黑名单中，不能添加好友。
25465不在当前用户白名单中，不能添加好友。
25466操作无效，该好友请求不存在或已经过期。
25467当前用户好友数超出上限。
25468目标用户好友数超出上限。
25469非好友关系，不能执行此操作。
25470好友自定义属性超出上限。
25471对方设置了不允许加为好友。
25472好友不存在。
25473不能添加自己为好友。
26020未开启在线状态订阅功能。
26021用户被订阅量达到上限，详细查看开发文档。
26022订阅用户数达到上限，详细查看开发文档。
34306订阅相关接口传入的订阅类型不支持。
34307订阅相关接口传入的订阅时长非法。
34308订阅相关接口传入的订阅用户列表非法。
34309订阅相关接口传入的分页大小非法。
34312参数 userProfile 非法。
34313参数 userProfileVisibility 非法。
34314参数 extra 无效。
34315数据库升级失败。
34318开发者接口调用时传入的参数 GroupInfo 非法。
34319开发者接口调用时传入的参数 groupId 非法。
34320开发者接口调用时传入的参数 groupName 非法。
34321开发者接口调用时传入的参数 groupIds 非法。
34322开发者接口调用时传入的参数 GroupMemberRole 非法。
34323开发者接口调用时传入的参数 GroupApplicationStatus 非法。
34324开发者接口调用时传入的参数 GroupApplicationDirection 非法。
34325开发者接口调用时传入的参数 nickname 非法。
34326开发者接口调用时传入的参数 reason 非法。
34327开发者接口调用时传入的参数 remark 非法。
34328开发者接口调用时传入的参数 PagingQueryOption 非法。
34329数据正在同步中。
34330开发者接口调用时传入的参数 QueryFriendsDirectionType 非法。
34331开发者接口调用时传入的参数 DirectionType 非法。
34332开发者接口调用时传入的参数 FriendApplicationType 非法。
34333开发者接口调用时传入的参数 FriendApplicationStatus 非法。
34334开发者接口调用时传入的参数 FriendAddPermission 非法。
34335开发者接口调用时传入的参数 extProfile 非法。

APNs 推送状态码​

下面列举了在控制台，上传 APNs 推送证书后，推送测试过程中，可能遇上的错误码、原因以及需要进行的排查处理。

错误码原因处理。
5, 8deviceToken 信息有误。请检查设备是否越狱，setDeviceToken 传入的参数是否正确，Xcode 在打包时使用的provisioning profile 是否与当前环境匹配。
52当前环境下 UserId 不存在，请确认一下是否连接服务器成功，init 使用的 App Key 是否是对应环境的 App Key。connectWithToken 的 success Block 会回调当前登陆的 UserId ，您可以查一下和您测试 Push 输入的是否一致。
53您上传的推送证书为空。检查并重新上传证书，并检查您填写的 BundleID 和证书中的 BundleID 是否对应)。
54, 62您上传的证书或者证书密码有问题。请检查您填写的证书密码，检查并重新上传证书，并检查您填写的 BundleID 和证书中的 BundleID 是否对应。
55该 userId 当前未在 iOS 设备上登录。请检查是否在 iOS 设备上成功登陆，是否存在多端登陆同一个 userId 的情况。
57发送苹果 Push 失败。SSL 解析异常，重新上传证书。
2, 56该 userId 没有设置 deviceToken 信息。请检查设备是否越狱，用户是否允许 App 进行通知，是否请求了远程推送权限以及 setDeviceToken 是否设置正确。
58原始参数解析失败。请联系我们尽快解决问题。
60socket 异常。内部错误，重新发送。
61该 userId 设置了屏蔽推送。请检查客户端是否屏蔽了推送功能（如果您有多个客户端或者 App 使用同一个 Appkey，请检查一遍所有的客户端代码是否设置了屏蔽推送）。
3, 4, 6, 7, 64网络原因，推送失败，请您再次尝试。网络原因，请重试。
0, 1, 10, 255，59Apple APNS 服务器服务异常。请过一段时间再尝试。
66上传的证书与当前环境不匹配。请检查并重新上传证书。
67您上传证书的密码错误，请核对您的证书和密码。请检查证书和密码，重新上传证书或填写密码。
68开发者平台填写的Bundle ID和证书中的Bundle ID不匹配，请检查。请检查填写的BundleID和证书Bundle ID。
70VoIP Push Token 为空。请确认 VoIP Push Token 是否为空。
73没有用户信息，此用户 ID 没有获取过融云 Token。重新获取用户 Token。
74上传证书包名与配置包名不一致。请检查上传证书包名与配置包名是否一致。
75上传的证书包含的 BundleId 含有通配符。按照苹果的要求，使用通配符的 App 无法使用APNs远程推送。
1050APNS 返回超时，您可能延时收到推送消息，也可能推送失败。网络原因，请重试。
编辑此页
最后由 Gordon Zhu 于 更新