主题
Skip to content 
错误码使用方式
初始化SDK时打开调试模式（debugMode: true）即可同步开启错误码打印，当SDK运行遇到问题时会在控制台输出错误码；
错误码输出注解
错误码分两部分：字母 + 四位数字，如T1200
错误码T1200: 该错误码为T开头，首先在左边的目录中找到T开头的分区，跳转到该分区后按照顺序即可找到T1200错误码详情
错误码对照表
核心支持服务（C开头）
| 错误码 | 错误码所属模块 | 错误描述 | 上报新事件 | 是否附带错误日志 | 错误原因 |
|---|---|---|---|---|---|
| C0000 | 1.3 隐私初始化 | 获取隐私文本失败 | 网络请求隐私文本失败，可能是网络波动导致 | ||
| C0001 | 打开微信官方隐私页面错误 | 微信自己接口打开隐私页面失败，可能是在开发者工具中调试且没有打开忽略域名隔离 | |||
| C1000 | 3.4 硬盘缓存初始化 | 缓存文件读取错误 | 文件io读取文件时读取失败 | ||
| C1001 | 首次创建专属缓存文件夹失败 | 首次创建专属缓存文件夹失败 | |||
| C2000 | 3.5 网络基础 | 网络请求超时终止 | 当网络请求在3.5秒内没有响应时，将中断该次请求。该错误发生只与服务器接口稳定性，或者网络速度有关 | ||
| C2001 | 网络请求响应异常 | 响应异常，具体错误可看失败回调 | |||
| C2100 | 3.6 登录 | 渠道登录失败 | 调用渠道的登录接口失败。请查看报错详细日志针对性解决 | ||
| C2102 | 服务器登陆失败 | 登录服务器时获取openId出错。请查看报错详细日志针对性解决 | |||
| C2200 | 3.7 服务器配置 | 获取服务器配置失败 | 请求线上参数错误，可能是网络请求超时 | ||
| C2300 | 4.2 服务器游戏数据 | 服务器保存功能开启，但是没有于在线参数配置ServerSave参数 | 后台没配ServerSave参数 | ||
| C2301 | 传入的注册参数错误 | 业务层人为失误必须解决。业务层keysList传参不合规，传入的注册参数需要长度不为0的数组 | |||
| C2302 | 想要读取的参数错误 | 传参不合规，传入的请求key必须是数组/字符串类型 | |||
| C2303 | 该平台不支持服务器存储，但仍在调用功能，被SDK禁止了 | 不支持的平台或者在调用初始化时没有传serverData为true | |||
| C2304 | 未提供key传参 | 没有传入注册的索引，检查一下传参 |
通用服务（T开头）
| 错误码 | 错误码所属模块 | 错误描述 | 上报新事件 | 是否附带错误日志 | 错误原因 |
|---|---|---|---|---|---|
| T0001 | 9 归因系统 | 未提供初始化对象 | 业务层人为失误必须解决。归因初始化传参有问题 | ||
| T0002 | 初始化未提供引力accessToken | 业务层人为失误必须解决。归因初始化未提供引力accessToken | |||
| T0003 | 未检测到引力SDK | 没将引力文件打入包内，检查是否有gravityengine.mg.cocoscreator.min 文件 | |||
| T0004 | 引力SDK版本过旧 | 引力SDK版本过旧 | |||
| T0005 | 引力引擎上报用户注册失败 | 需要查看报错信息针对性解决，引力后台事件流的错误事件也可看到报错(鼠标挪到感叹号上面) | |||
| T0006 | 归因上报失败，还未初始化 | 业务层人为失误必须解决。忘记调用init方法初始化就在归因上报。请注意init方法是异步 | |||
| T0007 | 归因上报未提供入参对象 | 业务层人为失误必须解决。reportEvent没传参 | |||
| T0008 | 归因上报类型枚举选择错误 | 业务层人为失误必须解决。eventType须用内置枚举 | |||
| T0009 | 支付归因的传参payAmount需为正整数 | 业务层人为失误必须解决。 | |||
| T0010 | 支付归因的传参payType需为3位字母 | 业务层人为失误必须解决。 | |||
| T0011 | 支付归因的传参orderId需为需为非空字符串 | 业务层人为失误必须解决。 | |||
| T0012 | 支付归因的传参payReason需为需为非空字符串 | 业务层人为失误必须解决。 | |||
| T0013 | 支付归因的传参payMethod需为需为非空字符串 | 业务层人为失误必须解决。 | |||
| T0014 | 广告归因的adType不在支持列表中 | 业务层人为失误必须解决。adType需使用内置枚举 | |||
| T0015 | 广告归因的adUnitId需为非空字符串 | 业务层人为失误必须解决。adType需使用内置枚举 | |||
| T0016 | 当前渠道不允许手动广告归因上报 | 业务层人为失误必须解决。只有微信需要手动调广告上报，其他渠道都不用 | |||
| T1200 | 4.3 分享 | 服务器分享配置无法解析 | 需检查在线配置的shareInfo是否配置正确,报错是因为无法反序列化 | ||
| T1201 | 未找到分享在线配置 | 发布需要在 在线配置后台设置shareInfo字段 | |||
| T1202 | 没有找到玩法key对应的分享信息 | 没有找到玩法key对应的分享信息，请检查本地和在线配置 | |||
| T2000 | 4.1 审核 | 地区审核获取配置失败 | 获取在线配置错误，可能是网络波动导致 | ||
| T3000 | 4.4 敏感词图检测 | 敏感词检测失败 | 敏感词网络请求接口失败，可能是网络波动导致 | ||
| T3001 | 敏感图检测失败 | 敏感图网络请求接口失败，可能是网络波动导致 |
渠道服务（Q开头）
| Q1200 | 抖音客服 | 当前应用不支持调用 | |||
|---|---|---|---|---|---|
| Q1201 | 拉起客服会话失败 | 抖音极速版有可能会触发一次。其他渠道请查看报错打印 |
广告服务（A开头）
| 错误码 | 错误描述 | 上报新事件 | 是否附带错误日志 | 错误原因 |
|---|---|---|---|---|
| A0000 | 三方api不存在 | 平台当前应用版本不支持该广告接口 | ||
| A0001 | 本次启动时请求广告配置下发接口返回的数据为空，会使用上次成功拉取的广告配置 | 配置下发接口响应成功但未返回任何有效信息，会使用本地缓存的广告配置 | ||
| A0002 | 配置下发接口网络请求失败 | 请求广告配置时网络响应异常 | ||
| A0003 | 配置返回状态码为0，返回的广告配置字段为空数组 | 找发布确认是否关了所有广告位的配置 | ||
| A0004 | 配置返回状态码为0，未返回adzs字段或adzs字段为空 | 异常情况，若出现反馈给平台侧研发 | ||
| A0005 | 配置返回状态码为-1 | 广告配置下发接口返回的系统异常，必现时反馈给平台侧 | ||
| A0006 | 服务端返回未约定的状态码 | 广告配置下发接口返回未被定义的错误码，反馈给平台侧 | ||
| A0007 | 当前使用的广告配置内无任何广告配置 | 当前使用的广告配置无任何广告配置，出现时先找发布确认配置情况，确认后台已配置推广位的话反馈给平台侧 | ||
| A1000 | 无视频推广位 | 出现该错误码时需要找发布方确认是漏配置还是不需要视频广告 | ||
| A1001 | 视频展示失败，无视频广告配置 | 无视频配置，联系发布同事确认视频推广位位是否配置 | ||
| A1002 | 视频展示失败，延迟时间内不展示视频广告 | 广告后台设置了进入游戏一定时间后才会展示视频 | ||
| A1003 | 视频展示失败，无网络 | 检测到网络断开，无法展示视频 | ||
| A1004 | 视频展示失败，调用三方展示接口时报错 | 当次调用视频展示失败 | ||
| A1005 | 视频展示失败，已有视频展示中 | 出现在视频即将展示时重复点击了视频点，如果在视频未播放成功且每次点击视频点重复出现该错误码时为异常情况，将日志反馈给平台研发 | ||
| A1006 | 视频展示失败，无广告实例 | 视频广告已被销毁，重试一下 | ||
| A1900 | 视频展示失败，配置文件中未配置videoId字段 | 检查配置文件中是否配置videoId字段并赋值 | ||
| A2000 | 无插屏推广位 | 出现该错误码时需要找发布方确认是漏配置还是不需要插屏广告 | ||
| A2001 | 插屏展示失败，无插屏广告配置 | 联系发布同事确认插屏推广位是否配置 | ||
| A2002 | 插屏展示失败，延迟时间内不展示插屏广告 | 广告后台设置了进入游戏一定时间后才会展示插屏 | ||
| A2005 | 插屏展示失败，插屏设置了展示间隔，满足间隔时间才会请求插屏并展示 | 插屏设置了展示后需要间隔一定时间才能展示下一个插屏 | ||
| A2008 | 插屏展示失败，插屏当前被设置为了不可展示状态，本次不展示 | 某些不允许展示插屏的场景下（如隐私页面）触发插屏展示逻辑会抛出该错误码，为正常现象；若在可展示插屏的页面出现了该错误码请确认是否未正确设置插屏可展示状态 | ||
| A2101 | SDK插屏创建失败，未配置SDK插屏推广位 | 联系发布同事确认SDK插屏是否未配置 | ||
| A2104 | SDK插屏调用三方展示接口时报错 | 当次插屏展示失败，观察后续调用是否正常 | ||
| A2106 | SDK 插屏展示失败，无广告实例 | 广告实例被销毁，等待下次创建 | ||
| A2900 | 插屏展示失败，配置文件中未读取到insertId字段，请联系发布确认 | 检查配置文件中是否配置insertId字段并赋值 |
支付服务（P开头）
| 错误码 | 错误描述 | 上报新事件 | 是否附带错误日志 | 错误原因 |
|---|---|---|---|---|
| P0000 | 未找到平台支付模块 | 当前平台未支持支付功能接入； | ||
| P0003 | 支付接口调用过于频繁 | 内部支付接口调用频控，每秒最多只能调用一次可在错误码后的日志中查看触发频控的接口名 | ||
| P1000 | 支付初始化失败 | 支付组件初始化失败，失败详情请看错误码后的日志 | ||
| P1001 | 获取商品列表失败，服务端接口返回的数据中data为空数组或data字段不存在 | 找发布同事确认是否未提供商品配置让支付服务端进行配置 | ||
| P1002 | 获取商品列表失败，商品查询接口请求失败 | 网络问题导致未获取到商品列表 | ||
| P1003 | 三方接口上未提供支付接口，无法成功调用支付弹窗 | 常见于三方应用版本过低（基础库版本低于支付接口要求的最小基础库版本）解决方法：确认符合上述情况后将应用升级到支持支付接口的版本 | ||
| P2000 | 购买失败，支付接口未传入参数 | 游戏层调用购买接口时未传入参数 | ||
| P2001 | 购买失败，网络已断开 | 检测到网络断开，无法购买 | ||
| P2002 | 购买失败，用户openId获取失败 | 重新启动游戏 | ||
| P2003 | 购买失败，用户sessionKey获取失败 | 重新启动游戏 | ||
| P2004 | 购买失败，服务端配置的商品列表内不存在该商品 | 可在错误码下一行的日志找到prodId并进行配置 | ||
| P2005 | 购买失败，商品列表获取失败 | 网络请求失败，可能原因是正式支付域名未加白名单 | ||
| P2006 | 购买失败，预下单失败 | 若高频出现该错误码请反馈给平台侧 | ||
| P2007 | 购买失败，验单不通过 | |||
| P2008 | 购买失败，向支付服务端发送道具上报时失败了或者游戏内传入的success回调报错 | 如果是游戏内的success回调报错，可在日志中查看报错详情 |
点我快速对接
