提供使用融云 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 开发者接口调用时传入的参数错误。请检查接口调用时传入的参数类型和值。
网友评论