全部产品
云市场
云游戏

网关结果码说明

更新时间:2020-07-31 13:39:08

网关侧结果码

  • 1000 为 API 调用成功,其他都是失败的错误码。
  • 1001-5999、7XXX 为网关错误。
    • 其中,7XXX 表示无线保镖验签或解密报错,具体参见 无线保镖结果码说明 进行排查。
    • 除结果码外,您还可以查看响应 Header 中的 Memotips 字段,以了解更多错误信息。
    • 专有云用户还可以通过网关服务器上的 ~/logs/gateway/gateway-error.log 日志查看详细错误信息。
  • 当发生异常时,可以尝试通过网关异常排查进行排查。欲了解具体信息,参见 网关异常排查
结果码 描述 解释
1000 处理成功 网关 API 调用处理成功。
1001 拒绝访问 开启 数据加密 后,当 RPC 数据解密失败会异常。
1002 调用次数超过限额 开启 限流配置 后,当触发限流时会导致该异常。
1005 未授权 开启 API 授权 后,API 调用时授权校验失败。
2000 登录超时 开启授权校验功能,非登录状态会触发该异常。
3000 RPC 接口不存在或关闭 在当前 workspaceId 对应的环境下,appId 对应的移动应用没有配置该 operationType 的 API 服务,或者该 API 服务不处于 开放 状态。
3001 请求数据为空 客户端请求数据中的 requestData 为空。请检查客户端 RPC 是否正常,iOS 端需确认已 初始化网关服务
3002 数据格式有误 RPC 请求格式有问题。专有云用户可以在服务端日志 gateway-error.log 中查看详细信息。
3003 数据解密失败 数据解密失败。
4001 服务请求超时 MGS 调用业务系统服务超时。后端业务系统负载过高导致,需排查后端系统的运行情况。若超时设置不合理,可以适当调整。注:默认超时时间为 3s。
4002 远程调用业务系统异常 MGS 调用业务系统服务出现异常。专有云用户可以在服务端日志 gateway-error.log 中查看详细信息。
4003 API 分组 HOST 异常 MGS 调用 HTTP 业务系统服务出现 UnknownHostException 异常。请检查 API 分组配置的域名是否存在。
5000 未知异常 其他严重错误。专有云用户可以在服务端日志 gateway-error.log 中查看详细信息。
7000 没有设置公钥 移动 APP 中无线保镖中无 appId 对应的密钥或者网关无法获取 appId 对应的签名密钥。
7001 验签的参数不够 网关服务端验证签名不通过。
7002 验签失败 网关服务端验证签名不通过。
7003 验签-时效性失败 API 请求入参 ts 时间戳超过系统设置的时间有效性。需要检查客户端时间是否为系统时间。
7007 验签-缺少 ts 参数 API 请求缺少验签 ts 参数。
7014 验签-缺少 sign 参数 API 请求缺少验签 sign 参数。一般情况下是客户端签名数据失败,导致缺失 sign 参数。请检查客户端无线保镖图片是否正确。
8002 跨域预检请求(CORS preflight) 跨域预检请求。

业务侧结果码

以下结果码,可在业务系统服务器内部查看错误信息。

通过查看各个业务系统上的 ~/logs/mobileservice/monitor.log 日志可确定异常具体信息。

结果码 适用协议 描述 解释
6000 MPC、DUBBO RPC-目标服务找不到 发布的服务(service)无法找到,服务器无法访问或者服务已迁移。
6001 MPC、DUBBO RPC-目标方法找不到 发布的该 service 内的方法无法找到。
6002 MPC、DUBBO RPC-参数数目不正确 传入的参数个数,与声明的参数个数不相等。
6003 MPC、DUBBO RPC-目标方法不可访问 目标方法不能被调用。
6004 HTTP、MPC、DUBBO PRC-JSON 解析异常 HTTP:将 RPC 参数转换为后端 HTTP 请求参数时发生异常。
MPC/DUBBO:将 RPC JSON 数据反序列化为业务参数对象时失败。
6005 MPC、DUBBO PRC-调用目标方法时参数不合法 反射调用时,参数不合法。
6007 MPC、DUBBO PRC-验证登录服务不可用 没有实现 SPI 包中验证登录接口或者验证登录接口配置出错。
6666 HTTP、MPC、DUBBO RPC-业务抛出异常 HTTP:后端系统返回 HTTP status code 不等于200。
MPC/DUBBO:业务方抛出的异常。RPC 无法处理,统一为业务异常。

Android 客户端结果码

结果码 描述 提示文案
0 未知错误 未知错误,请稍后再试
1 客户端找不到通讯对象,没有设置 Transport 网络出错,请稍后再试
2 客户端没有网络,如用户关闭了网络或者禁止了应用的网络权限 网络无法连接
3 SSL相关错误,包括 SSL 握手错误,SSL 证书错误 客户端证书有误,请检查手机的时间设置是否准确。
4 客户端网络连接超时,TCP 建连超时,目前超时时间为 10s 网络不给力
5 客户端网络速度过慢,数据读写超时,socketTimeout 的场景 网络不给力
6 客户端请求服务端无响应,NoHttpResponseException 网络出错,请稍后再试
7 客户端网络 IO 错误,对应 IOException 网络出错,请稍后再试
8 客户端网络请求调度错误,执行线程中断异常 网络出错,请稍后再试
9 客户端处理错误,包括序列化错误、注解处理错误、线程执行错误 网络出错,请稍后再试
10 客户端数据反序列化错误,服务端数据格式有误 网络出错,请稍后再试
13 请求中断错误,例如线程中断时网络请求会被中断 网络出错,请稍后再试
15 客户端网络授权错误,HttpHostConnectException,Connection to xxx refused,无网络或者对应服务器拒绝连接 网络无法连接
16 DNS 解析错误 网络无法连接,请稍后再试
18 网络限流,客户端限流,当客户端请求流量超过阈值后会被限制网络请求 网络限流,请稍后再试
code >= 400 和 code < 500 HTTP 响应码为 4xx 网络无法连接
400 > code >= 100 和 500 < code < 600 HTTP 非成功的响应码 网络无法连接,请稍后再试