主题
错误码参考
文档版本 v1.0.0
本页对应 SDK 1.0.0，与离线包 docs/ 目录里的同一份文档内容一致。其他版本见文档中心。
错误由 AdError 承载。负数码是 AdMix 自己的，其余是广告平台的原始错误码， 原样透传、没有做任何映射，AdError.adnType 标明来源平台。
AdMix 错误码
| 码 | 含义 | 处理 |
|---|---|---|
| -1001 | SDK 未初始化 | 检查 init() 的调用位置与 init() / start() 的调用顺序 |
| -1002 | 广告位无配置 | 广告位标识拼错，或平台运营还没给这个广告位配广告源 |
| -1003 | 所有广告源均无填充 | 正常现象。按下方各平台的错误码定位是哪一家的问题，并检查平台广告位状态与填充率 |
| -1004 | 整体超时 | 请平台运营调大该广告位的 total_timeout_ms |
| -1005 | Adapter 不可用 | 该广告平台的适配器没被发现。先看启动日志里有没有 adapter 就绪: xxx —— 没有就是依赖没引，或自定义打包策略把 META-INF/services/** 排除了 |
| -1006 | 用户尚未同意隐私政策 | start() 还没调（或调了但回调 onFail）就请求了广告。这是 SDK 的兜底红线：未同意时任何 load() 都不会碰到广告 SDK |
穿山甲错误码
| 码 | 含义 | 怎么办 |
|---|---|---|
| 602 | 未知异常 | 平台广告位 ID 填成了 GroMore 瀑布流里的代码位 ID。穿山甲后台有两层 ID：「应用管理」页的广告位 ID（10 开头 9 位）是要填的那个，「瀑布流管理」里每一行的代码位 ID 平台不使用。错误信息毫无指向性，见《策略配置格式》「穿山甲后台配置」 |
| 20001 reason:234 | 聚合代码位只能在聚合场景使用 | SDK 没跑在聚合模式下，属开发侧问题 |
| 20001 reason:112 | 无效重复请求过多 | 测试期高频请求同一广告位时常见，换台设备或隔一会儿再试 |
| 20005 | 广告位下全部代码位均请求失败 | 要么瀑布流没配代码位，要么确实无填充 —— 按下方「区分瀑布流漏配与真无填充」判断 |
| 40006 | 广告位 ID 不合法 | 常见于 Banner 尺寸与后台广告位规格不匹配。把实际使用的 Banner 尺寸告知平台运营，按同一规格建广告位 |
区分瀑布流漏配与真无填充
debug(true) 时 SDK 会自动打开 GroMore 的错误明细开关，20005 的 message 里会带上每一家的 失败原因，形如：
text
csj 20005 [{"adn_name":"pangle","mediation_rit":"***","error_code":20001,"error_msg":"reason: 112 ..."}]| 方括号里 | 结论 |
|---|---|
| 是空的 | 瀑布流里一个代码位都没配，找平台运营在穿山甲后台「瀑布流管理」里补 |
| 有内容 | 瀑布流配了，是各家自己没填充。看里面每家的 error_msg |
优量汇错误码
| 码 | 含义 | 怎么办 |
|---|---|---|
| 107076 | 请求包名与在优量汇注册的媒体全包名一致才返回广告 | 包名与优量汇后台登记的不一致，见下方「两个包名字段」 |
| 5004 | 没有匹配到合适的广告资源 | 调试期正常无填充 —— 但包名不符时也可能报这个（实测返回码不稳定，有时 107076 有时 5004）。先按 107076 排查包名，排除后再当成真无填充 |
| 5006 | 包名校验错误 | 平台广告位被多个包名共用。优量汇广告位属于媒体、媒体绑定包名，不能共用，找平台运营为该应用单独建 |
| 107030 | App 包名无效 | 优量汇后台**「程序全包名」**填错，见下方「两个包名字段」 |
| 100133 | 广告位状态异常 / 新建未满 30 分钟 | 等 30 分钟，或找平台运营查后台状态 |
| 3003 | 网络不可用 | 检查设备网络 |
两个包名字段
最容易卡住的一条。优量汇后台有「主程序包名」和「程序全包名」两个字段， 服务端校验的是「程序全包名」。
两者不一致就报 107030，而错误文案只说「和注册时填写的一致」，不告诉是哪个字段。 向平台运营报包名时，把两个字段分别念出来逐字核对。
日志里看不到具体广告位 ID
日志里的价格和平台广告位 ID 一律显示为 ***，与 debug 开关无关。 需要定位到具体广告位时，把广告位标识 + 广告平台 + 出问题的时间点交给平台运营查询。
报障时请一次给全：广告位标识、广告平台、出问题的时间点、adb logcat -s "AdMix:V" 的原始日志、 以及是 Debug 包还是 Release 包。