提供使用融云 SDK 及 Server API 接口时，可能遇上的状态码、原因及需要进行的处理方式。

Server API 状态码

HTTP 状态码

code       描述                 详细解释

200         成功                 成功

400         错误请求         该请求是无效的，详细的错误信息会说明原因

401        未授权              验证失败，详细的错误信息会说明原因

403        服务器拒绝请求  被拒绝调用，详细的错误信息会说明原因

404        未找到              服务器找不到请求的地址

405        方法禁用          群容量超出上限，禁止调用

429        太多的请求      超出了调用频率限制，详细的错误信息会说明原因

500        服务器内部错误  服务器内部出错了，请联系我们尽快解决问题

504        网关超时           服务器在运行，本次请求响应超时，请稍后重试

业务返回码

code     描述                   详细解释                                                                            HTTP 状态码

404       未找到              服务器找不到请求的地址                                                   404

1000     服务内部错误   服务器端内部逻辑错误,请稍后重试                                 500

1001     App Secret 错误   App Key 与 App Secret 不匹配                                   401

1002     参数错误          参数错误，详细的描述信息会说明                                   400

1003     无 POST 数据  没有 POST 任何数据                                                          400

1004     验证签名错误   验证签名错误                                                                       401

1005     参数长度超限   参数长度超限，详细的描述信息会说明                          400

1006     App 被锁定或删除   App 被锁定或删除                                                      401

1007     被限制调用        该方法被限制调用，详细的描述信息会说明                  401

1008     调用频率超限    调用频率超限，详细的描述信息会说明，广播消息未开通时也会返回此状态码。                                                                                                            429

1009     服务未开通        未开通该服务，请到开发者管理后台开通或提交工单申请。430

1015     删除的数据不存在    要删除的保活聊天室 ID 不存在。                             200

1016     设置保活聊天室个数超限    设置的保活聊天室个数超限。                       403

1050     内部服务超时   内部服务响应超时                                                                504

2007     测试用户数量超限   测试用户数量超限                                                        403

Android、iOS 状态码

下面列举了 SDK 使用过程中，可能遇上的错误码、原因以及需要进行的处理。

code        原因

-3             参数错误（Android 平台）。

-2IPC      进程意外终止（Android 平台）。

405         已被对方加入黑名单。

20604     发送消息频率过高， 1 秒钟最多只允许发送 5 条消息。

21406     不在该讨论组中。

22406     不在该群组中。

22408     在群组中已被禁言。

23406     不在该聊天室中。

23408     在该聊天室中已被禁言。

23409     已被踢出并禁止加入聊天室。

23410     聊天室不存在。

23412     聊天室接口参数无效。

23414     聊天室云存储业务未开通。

24012     通话鉴权失败。

24014     实时音视频功能未开启。

24016     实时音视频功能已关闭。

25101     消息撤回时，参数错误。

29106     未关注此公众号。

29201     无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)。

30001     当前连接不可用（连接已经被释放）。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30002     当前连接不可用。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30003     消息响应超时。

30004     导航 HTTP 发送失败。如果是偶尔出现此错误，SDK 会做好自动重连，开发者无须处理。对于 iOS 平台，如果一直连接不上，应该是您没有设置好 ATS。ATS 默认只使用 HTTPS 协议，当 HTTP 协议被禁止时 SDK 会一直 30004 错误。您可以在我们 iOS 开发文档中搜索到 ATS 设置。

30007     导航 HTTP 请求失败。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

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

30010      Socket 不存在，一般由于没有 connect() 引起的。

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

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

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

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

30015       连接过于频繁。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。

30016        消息大小超限，消息体（序列化成 JSON 格式之后的内容）最大 128k bytes。

30017        请求内存分配失败，可能是手机内存不够等原因引起的。

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

31002         App Key 错误。请检查您使用的 App Key 是否正确。

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

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

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

31007          BundleID 不正确。请检查您 App 的 BundleID 是否正确。

31008          App Key 被封禁或已删除。请检查您使用的 App Key 是否正确。

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

31010           当前用户在其他设备上登录，此设备被踢下线

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

33001           SDK 没有初始化，在使用 SDK 任何功能之前，必须先调用 Init。

33002           数据库错误，请检查您使用的 Token 和 userId 是否正确。

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

33007          历史消息云存储业务未开通。

-1000         开发者接口调用时传入的参数错误。请检查接口调用时传入的参数类型和值。