SDK 错误码
本文档汇总 APP 客户端接入 OpenPaaS SDK 过程中可能遇到的通用错误码。SDK 接口或回调返回失败时,可根据错误码和错误信息定位问题,再结合当前调用场景排查鉴权凭证、应用配置、会话状态或业务参数。
一、错误码说明
0表示成功。- 非
0表示失败,需结合 SDK 返回的错误信息与当前调用场景处理。 - 「错误信息」为 SDK 返回的英文错误描述,「说明」为对应的中文含义。
二、错误码表
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 0 | success | 成功 |
| 10001 | service exception | 服务异常 |
| 10002 | invalid params | 参数错误 |
| 10401 | invalid access token | 无效的访问token |
| 10450 | missing http header | 缺少http头 |
| 10460 | invalid signature | 签名错误 |
| 10461 | invalid encrypt | 错误的加密 |
| 42001 | access token expired | 访问token过期 |
| 42002 | invalid app id | 无效的应用id |
| 42003 | invalid app key | 无效的应用key |
| 42004 | app id mismatch between header and token | 请求头与token中的appId不匹配 |
| 42005 | app id mismatch between header and request body | 请求头与请求体中的appId不匹配 |
| 42006 | invalid app platform | 无效的应用平台 |
| 42010 | invalid refresh token | 无效的刷新token |
| 42011 | invalid user signature | 无效的用户签名 |
| 42013 | invalid session id | 无效的会话id |
| 42015 | not found app config | 未找到应用配置 |
| 42016 | invalid game id | 无效的游戏id |
| 42020 | missing user token | 缺少用户token |
| 42021 | invalid user token | 无效的用户token |
| 42022 | not found session | 未找到会话 |
| 42030 | invalid sign data | 无效的签名数据 |
| 42031 | invalid product id | 无效的商品id |
| 42032 | product price error | 商品价格错误 |
| 42033 | pay signature error | 支付签名错误 |
| 42034 | signature error | 签名错误 |
| 42035 | duplicated out trade no | 重复的外部交易号 |
| 42036 | invalid trade no | 无效的交易号 |
| 42037 | missing game pay secret | 缺少游戏支付密钥 |
| 42038 | missing app data asymmetric key | 缺少应用数据非对称密钥 |
| 42039 | missing app data symmetric key | 缺少应用数据对称密钥 |
| 42100 | not found available package | 未找到可用包 |
| 42101 | not linked game | 未关联游戏 |
| 42102 | missing game metadata | 缺少游戏元数据 |
| 42103 | missing game support info | 缺少游戏支持信息 |
| 43040 | invalid ad type | 无效的广告类型 |
| 43041 | invalid ad unit id | 无效的广告位ID |
| 43042 | sud trans id error | sud trans id生成错误 |
| 43043 | invalid ad event type | 无效的广告上报事件类型 |
三、排查建议
- 鉴权与凭证类错误(如
10401、42001、42010、42020、42021)优先检查用户登录态、访问凭证和刷新凭证是否有效。 - 应用或游戏配置类错误(如
42002、42003、42006、42015、42016)优先核对应用 ID、应用 Key、应用平台和游戏配置。 - 会话与签名类错误(如
42011、42013、42022、42030、42034)优先检查会话状态、签名数据和签名生成逻辑。 - 支付或广告类错误(如
42031、42033、43040、43041、43043)需结合对应业务能力的入参和后台配置排查。
