Cocos 接广告 SDK 加载失败怎么排查
Cocos 接广告 SDK 一直加载失败怎么办，我花了整整两天改代码，最后发现代码一行都没错。所以这篇最想先说清的不是怎么改，是从哪里开始查。
那次的现象是：本地模拟器广告正常出，构建成微信小游戏包之后，日志里始终没有广告加载成功的记录。我一直以为是 Cocos 这边调用写错了。
真正的原因是广告位还没在后台生效，代码写对了也没用。
坑一：在模拟器里验证真机行为
现象： 本地调试一切正常，上了真机或者构建微信包之后没有广告。
为什么踩： 模拟器和微信小游戏客户端不是同一套运行环境。广告 SDK 依赖平台客户端能力，模拟器里往往走的是兜底或 mock 路径。
怎么避： 把「真机验证」当成接入流程里的固定一步，不是可选项。
具体动作：每接一个新广告位，拿一台没装过你小游戏的手机完整走一遍，看日志里有没有加载成功的记录。
坑二：广告位 ID 或类型配错
现象： 调用没报错，但广告就是不出现。
为什么踩： 不同广告类型对应不同的广告位 ID。拿激励视频的 ID 去创建插屏实例，或者复制粘贴时带上了多余空格，都会静默失败。
怎么避： 把每个广告位 ID 和它对应的类型写在一起，接入前逐个核对一遍。
具体动作：检查配置里有没有前后空格、有没有把测试 ID 和正式 ID 搞混。
坑三：初始化时机太晚
现象： 第一次调用一定失败，第二次可能就成功了。
为什么踩： 广告实例需要先创建再使用。如果等到用户点了按钮才去创建实例，那一次几乎必然失败。
怎么避： 把实例创建放在启动流程里，创建完立刻打一条日志。
具体动作：启动日志里必须能看到「实例创建成功」这句话，看不到就是时机问题。
坑四：只处理了成功回调
现象： 用户中途关掉广告，界面卡住不动。
为什么踩： 激励视频至少有三条分支——看完、中途关闭、加载失败。只处理成功那条，另外两条就没有出口。
怎么避： 三条分支各写一条日志，真机上逐条验证。
具体动作：主动在广告播放中途点关闭，看界面有没有回到正常状态。
坑五：以为失败是 SDK 的问题
现象： 反复怀疑版本、怀疑引擎、怀疑网络。
为什么踩： 加载失败的原因里，配置和后台状态占的比重比代码大得多。
我那次就是：广告位刚开、状态没生效，我在代码里找了两天。
怎么避： 先按「配置 → 后台状态 → 代码」的顺序排查，不要一上来就改代码。
具体动作：把广告位状态、ID、类型三项列成一张检查表，从表的第一行开始核。
坑六：没有可对比的基线
现象： 出问题后不知道是哪里变的。
为什么踩： 一次改了好几个地方——换了广告位、改了触发时机、动了引擎设置。出问题时你无法归因。
怎么避： 一次只改一个变量。
具体动作：接第二个广告位之前，先把第一个广告位的成功日志留存一份，作为基线。
止损清单
卡住超过一定时间，就按这个顺序走，别硬磕：
1. 停下来。 先把代码改动恢复到上一次能跑通的状态。
2. 核对配置。 广告位 ID、类型、前后空格，逐项过一遍。
3. 核对后台状态。 流量主是否开通、广告位是否生效，以后台实际显示为准。
4. 换成真机。 模拟器结论一律不作为依据。
5. 只保留一个广告位。 把其他全部关掉，把变量降到最少。
6. 记录失败日志。 把加载失败时的完整日志留下来，下次同类问题能省一半时间。
Cocos 接广告 SDK 一直加载失败怎么办：先查配置
我给自己定的线是：排查超过半天还没有方向，就回到「最小可跑通版本」重来。
这条线救过我好几次。加载失败这件事的最优解不是死磕，是把变量砍到最少，让失败自己暴露出来。
顺便提醒一句：我第一款自研小游戏上线后数日实测，种子计划 180 人/天进量、次日留存 5 人、人均时长不到 2 分钟、当日广告收入不到 ¥6。
这说明一件事：广告 SDK 接得再顺，产品留存不行，收入也不会好。 排查加载失败是技术活，但它不是决定收入的那一环。
所以回到标题那个问题，Cocos 接广告 SDK 一直加载失败怎么办，我最终的答案是先查配置和后台状态，再动代码。
常见问题
Q：Cocos 接广告 SDK 加载失败，该从哪查起？
A：按「配置 → 后台状态 → 代码」的顺序查。先核对广告位 ID 和类型是否匹配，再确认后台广告位已生效，最后才看代码时机问题。
Q：模拟器里广告正常，真机没有，怎么办？
A：模拟器结论不作为依据，直接在真机上复现并看日志。重点看广告实例创建和加载两条日志有没有出现。
Q：广告一直加载失败会不会是账号问题？
A：有可能，但先把配置项排除干净再去怀疑账号。后台的流量主状态和广告位状态以官方显示为准，不要凭印象判断。
相关阅读
本文作者西米，37 岁程序员，一个人加五个 AI 员工在跑一家公司。踩过的坑和真实账本都写在公众号「西米分享」。
完整代码、踩坑清单与最新进展，都在公众号。
📱 关注公众号「西米分享」