融云集成错误码汇总

最近集成了融云 IM SDK，过程中遇到了错误码，这时需要去 SDK 头文件找到对应的错误码查看原因。下列给大家整理了一下，希望可以帮到大家，如果还有疑问，可以联系融云的技术：

30007 : 导航 HTTP 请求失败。建议：更换网络环境，如无法解决，联系服务端排查（尤其是私有云）' :

31002 : AppKey 错误。请检查您使用的 AppKey 是否正确

30010 : 创建 Socket 连接失败。建议：一般是网络不好，需更换网络试一下。

31004 : Token 无效。建议：一是 token 错误，请您检查客户端初始化使用的 AppKey 和您服务器获取 token 使用的 AppKey 是否一致；二是 token 过期，是因为您在开发者后台设置了 token 过期时间，您需要请求您的服务器重新获取 token 并再次用新的 token 建立连接

31005 : AppKey 与 Token 不匹配。建议：请检查您使用的 AppKey 与 Token 是否正确，是否匹配。一般有以下三种原因。一是 token 错误，请您检查客户端初始化使用的 AppKey 和您服务器获取 token 使用的 AppKey 是否一致；二是 token 过期，是因为您在开发者后台设置了 token 过期时间，您需要请求您的服务器重新获取 token 并再次用新的 token。三是 App 校验未通过，是因为您在开发者后台设置了 App 校验建立连接。

31007 : BundleID 不正确。建议：请检查您 App 的 BundleID 是否正确

31008 : AppKey 被封禁或已删除。建议：请检查您使用的 AppKey 是否被封禁或已删除。

31009 : 用户被封禁。建议：检查您使用的 Token 是否正确，以及对应的 UserId 是否被封禁

31010 : 用户被踢下线。建议：当前用户在其他设备上登录，此设备被踢下线'

31023 : 用户在其它设备上登录。建议：重连过程中当前用户在其它设备上登录

33001 : SDK 没有初始化。建议：在使用 SDK 任何功能之前，必须先 init

33003 : 开发者接口调用时传入的参数错误。建议：请检查接口调用时传入的参数类型和值

34001 : Connection 已经存在。建议：调用过connect之后，只有在 token 错误或者被踢下线或者用户 logout 的情况下才需要再次调用 connect。其它情况下 SDK会自动重连，不需要应用多次调用 connect 来保持连接

34005 : 连接环境不正确。建议：融云公有云 SDK 无法连接到私有云环境。请确认需要连接的环境，使用正确 SDK 版本

34006 : 连接超时。建议：当调用 connectWithToken:timeLimit:dbOpened:success:error: 接口，timeLimit 为有效值时，SDK 在 timeLimit 时间内还没连接成功返回此错误

30011 : Socket 断开。建议：Socket 连接被断开，主要有两种情况，一是用户主动调用 disconnect 之后，Socket 被服务器断开；二是中间路由原因等导致 Socket 断开

30008 : 导航 HTTP 返回数据格式错误。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30004 : 导航 HTTP 发送失败，是否设置 ATS。建议：如果是偶尔出现此错误，SDK 会做好自动重连，开发者无须处理。如果一直是这个错误，应该是您没有设置好ATS。ATS 默认只使用 HTTPS 协议，当HTTP 协议被禁止时 SDK 会一直 30004 错误。您可以参考 iOS 开发文档中的 ATS 设置说明。链接如下：https://support.rongcloud.cn/ks/OTQ1

30012 : PING 失败。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30013 : PING 超时。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30014 : 信令发送失败。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

31000 : 连接 ACK 超时。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

31001 : 信令版本错误。建议：问融云的技术人员吧

31003 : 服务器当前不可用。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

31006 : 连接重定向。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

32061' : 连接被拒绝。建议：建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

20604 : 发送消息频率过高，1 秒钟最多只允许发送 5 条消息。建议：多个消息发送的时候中间加个延时

20607 : 请求超出了调用频率限制，请稍后再试。建议：不要多余频繁的调用接口

21406 : 当前用户不在该讨论组中

22406 : 当前用户不在该群组中。建议：到融云开发者后台 API 调用模块对应服务中进行查询

22408 : 当前用户在群组中已被禁言。建议：让开发者服务端人员确认一下是否在群组中

23406 : 当前用户不在该聊天室中。建议：到融云开发者后台 API 调用模块对应服务中进行查询核实

23408 : 当前用户在该聊天室中已被禁言。建议：到融云开发者后台 API 调用模块对应服务中进行查询核实

23409 : 当前用户已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。

23410 : 聊天室不存在。建议：到融云开发者后台 API 调用模块对应服务中进行查询核实

23411 : 聊天室成员超限，默认聊天室没有人数限制，开发者可以提交工单对某个 Appkey 进行聊天室人数限制，设置后加入聊天室时如果人数超限，会提示这个错误码

23412 : 聊天室接口参数无效。请确认参数是否为空或者有效

23414 : 聊天室云存储业务未开通。建议：到融云开发者后台进行开通

23423 : 超过聊天室的最大状态设置数，1 个聊天室默认最多设置 100 个

23424 : 聊天室中非法覆盖状态值，状态已存在，没有权限覆盖。建议：这个值只有创建者才能修改。如果必须修改，则需要调用 RCIMClient 中forceSetChatRoomEntry:key:value:sendNotification:autoDelete:notificationExtra:success:error:接口。具体请到 RCIMClient 中查看 API

23425 : 超过聊天室中状态设置频率，1 个聊天室 1 秒钟最多设置和删除状态 100 次。建议：降低设置和删除频率

23426 : 聊天室状态存储功能没有开通，请联系商务开通

23427 : 聊天室状态值不存在

26002 : 操作跟服务端同步时出现问题，有可能是操作过于频繁所致。如果出现该错误，请延时 0.5s 再试

34004 : 聊天室状态未同步完成，刚加入聊天室时调用获取 KV 接口，极限情况下会存在本地数据和服务器未同步完成的情况，建议延时一段时间再获取

30001 : 当前连接不可用（连接已经被释放），只能表明当前连接是断开的，具体原因还需要通过其他错误码分析

30002 : 当前连接不可用，只能表明当前连接是断开的，具体原因还需要通过其他错误码分析。建议：可能是网络不可用，请切换网络试一下

30003 : 客户端发送消息请求，融云服务端响应超时。建议：服务器可能有问题

33002 : 数据库错误，造成错误的原因：1. 需要保证连接融云成功并且数据库打开后再调用业务接口，比如发消息。2. userId 中包含特殊字符。

33003 : 开发者接口调用时传入的参数错误。建议：请检查接口调用时传入的参数类型和值

33007 : 历史消息云存储业务未开通。可以在融云开发者后台中开启该服务

30016 : 消息大小超限，消息体（序列化成 json 格式之后的内容）最大 128k bytes。建议：缩小消息体的大小，避免超过 128 k

25101 : 撤回消息参数无效。请确认撤回消息参数是否正确的填写

26001 : push 设置参数无效。请确认是否正确的填写了 push 参数

20605 : 操作被禁止。 此错误码已被弃用

20606 : 操作不支持。仅私有云有效，服务端禁用了该操作。

21501 : 发送的消息中包含敏感词 （发送方发送失败，接收方不会收到消息）

21502 : 消息中敏感词已经被替换 （接收方可以收到被替换之后的消息

34002 : 小视频时间长度超出限制，默认小视频时长上限为 2 分钟。建议：视频不要超过 2 分钟

34003 : GIF 消息文件大小超出限制， 默认 GIF 文件大小上限是 2 MB

34007 : 查询的公共服务信息不存在, 请确认查询的公共服务的类型和公共服务 id 是否匹配

34008 : 消息不能被扩展, 消息在发送时，RCMessage 对象的属性 canIncludeExpansion 置为 YES 才能进行扩展。建议：把RCMessage 对象的属性 canIncludeExpansion 置为 YES

34009 : 消息扩展失败, 一般是网络原因导致的，请确保网络状态良好，并且融云 SDK 连接正常

34010 : 消息扩展大小超出限制， 默认消息扩展字典 key 长度不超过 32 ，value 长度不超过 64 ，单次设置扩展数量最大为 20，消息的扩展总数不能超过 300

34011' : 媒体消息媒体文件 http 上传失败

标签：聊天室,汇总,建议,错误码,开发者,云集,连接,SDK
来源： https://blog.51cto.com/15056506/2678311