Skip to content

SDK 错误码 ​

本文档汇总 APP 客户端接入 OpenPaaS SDK 过程中可能遇到的通用错误码。SDK 接口或回调返回失败时,可根据错误码和错误信息定位问题,再结合当前调用场景排查鉴权凭证、应用配置、会话状态或业务参数。

一、错误码说明 ​

  • 0 表示成功。
  • 非 0 表示失败,需结合 SDK 返回的错误信息与当前调用场景处理。
  • 「错误信息」为 SDK 返回的英文错误描述,「说明」为对应的中文含义。

二、错误码表 ​

错误码错误信息说明
0success成功
10001service exception服务异常
10002invalid params参数错误
10401invalid access token无效的访问token
10450missing http header缺少http头
10460invalid signature签名错误
10461invalid encrypt错误的加密
42001access token expired访问token过期
42002invalid app id无效的应用id
42003invalid app key无效的应用key
42004app id mismatch between header and token请求头与token中的appId不匹配
42005app id mismatch between header and request body请求头与请求体中的appId不匹配
42006invalid app platform无效的应用平台
42010invalid refresh token无效的刷新token
42011invalid user signature无效的用户签名
42013invalid session id无效的会话id
42015not found app config未找到应用配置
42016invalid game id无效的游戏id
42020missing user token缺少用户token
42021invalid user token无效的用户token
42022not found session未找到会话
42030invalid sign data无效的签名数据
42031invalid product id无效的商品id
42032product price error商品价格错误
42033pay signature error支付签名错误
42034signature error签名错误
42035duplicated out trade no重复的外部交易号
42036invalid trade no无效的交易号
42037missing game pay secret缺少游戏支付密钥
42038missing app data asymmetric key缺少应用数据非对称密钥
42039missing app data symmetric key缺少应用数据对称密钥
42100not found available package未找到可用包
42101not linked game未关联游戏
42102missing game metadata缺少游戏元数据
42103missing game support info缺少游戏支持信息
43040invalid ad type无效的广告类型
43041invalid ad unit id无效的广告位ID
43042sud trans id errorsud trans id生成错误
43043invalid ad event type无效的广告上报事件类型

三、排查建议 ​

  1. 鉴权与凭证类错误(如 10401、42001、42010、42020、42021)优先检查用户登录态、访问凭证和刷新凭证是否有效。
  2. 应用或游戏配置类错误(如 42002、42003、42006、42015、42016)优先核对应用 ID、应用 Key、应用平台和游戏配置。
  3. 会话与签名类错误(如 42011、42013、42022、42030、42034)优先检查会话状态、签名数据和签名生成逻辑。
  4. 支付或广告类错误(如 42031、42033、43040、43041、43043)需结合对应业务能力的入参和后台配置排查。