微信小游戏激励视频广告返回code 1004如何解决？

Question

微信小游戏激励视频广告返回code 1004，通常表示“广告加载失败或资源异常”。常见原因之一是广告单元ID配置错误或未通过审核。此外，设备网络问题、用户短时间内频繁请求广告、SDK版本过低或缓存异常也可能触发该错误。部分情况下，开发者未正确监听广告关闭事件或在广告未准备完成时调用显示方法，也会导致code 1004。需检查广告加载与显示逻辑是否符合官方流程。

Answer 1

一、问题现象与基础定位

微信小游戏在调用激励视频广告时返回 code 1004，官方定义为“广告加载失败或资源异常”。该错误码属于常见广告加载类异常，在多个项目中频繁出现。初步排查通常从最表层因素入手：

• 广告单元ID（adUnitId）是否正确填写；
• 当前广告位是否已通过微信审核；
• 开发者是否在测试环境中误用了正式环境的广告ID；
• 是否存在拼写错误或复制粘贴遗漏字符的情况。

建议使用微信开发者工具的“广告调试模式”，通过 __wxConfig 或日志输出确认 adUnitId 的实际传值。

二、技术链路深度剖析

激励视频广告的完整生命周期包含：预加载 → 加载完成监听 → 用户触发展示 → 播放完成回调。若任一环节断链，均可能引发 code 1004。以下是典型执行流程：

// 示例代码：标准激励视频调用流程
const videoAd = wx.createRewardedVideoAd({ adUnitId: 'your_ad_unit_id' });

videoAd.onLoad(() => {
    console.log('广告资源加载成功');
});

videoAd.onError((err) => {
    console.error('广告错误:', err);
    // 此处 err.code 可能为 1004
});

videoAd.show().catch(err => {
    console.warn('展示失败，尝试重新加载');
    videoAd.load().then(() => videoAd.show());
});
    

三、多维度故障树分析

为系统化定位问题，构建如下故障分类表：

类别	具体原因	检测方式
配置类	adUnitId 错误或未审核	登录微信公众平台核对状态
网络类	设备弱网或DNS拦截	更换WiFi/4G测试
频率控制	短时间高频请求	添加防抖机制
SDK兼容性	基础库版本低于 2.6.0	检查 wx.getSystemInfoSync()
缓存异常	本地广告资源损坏	清除小程序缓存重试
逻辑错误	未等待 onLoad 完成就调用 show()	增加 Promise 包装器

四、高级诊断与优化策略

对于资深开发者，应引入自动化监控机制。以下为推荐的增强型封装结构：

class AdManager {
    constructor(adUnitId) {
        this.adUnitId = adUnitId;
        this.adInstance = null;
        this.isLoaded = false;
        this.init();
    }

    init() {
        if (!this.adInstance) {
            this.adInstance = wx.createRewardedVideoAd({ adUnitId: this.adUnitId });
            this.bindEvents();
        }
    }

    bindEvents() {
        this.adInstance.onLoad(() => {
            this.isLoaded = true;
        });

        this.adInstance.onError((err) => {
            Sentry.captureException(`Ad Error [${err.code}]: ${err.msg}`);
            this.isLoaded = false;
        });

        this.adInstance.onClose(res => {
            if (res && res.isEnded) {
                // 激励发放逻辑
            }
            // 无论是否看完都重新加载，维持可用性
            this.load();
        });
    }

    load() {
        if (this.isLoaded) return Promise.resolve();
        return this.adInstance.load().catch(err => {
            console.warn('Ad load failed:', err);
            throw err;
        });
    }

    async show() {
        try {
            await this.load();
            await this.adInstance.show();
        } catch (err) {
            if (err.code === 1004) {
                // 可结合上报系统进行聚合分析
                Analytics.track('ad_1004_error', { unitId: this.adUnitId });
            }
            throw err;
        }
    }
}
    

五、可视化流程与异常路径

使用 Mermaid 流程图展示激励视频的标准与异常路径：

graph TD
            A[初始化广告实例] --> B{广告ID有效?}
            B -- 否 --> Z[报错 code 1004]
            B -- 是 --> C[调用 load()]
            C --> D{加载成功?}
            D -- 否 --> E[触发 onError]
            E --> F{错误码 == 1004?}
            F -- 是 --> G[记录日志并重试加载]
            F -- 否 --> H[其他处理]
            D -- 是 --> I[调用 show()]
            I --> J{展示成功?}
            J -- 否 --> K[再次尝试 load + show]
            J -- 是 --> L[等待用户关闭]
            L --> M[发放奖励判断]

六、长期运维建议

针对 code 1004 的持续治理，建议实施以下措施：

1. 建立广告健康度监控面板，实时统计各广告位的加载成功率；
2. 对 error.code 进行埋点采集，按机型、城市、运营商维度做下钻分析；
3. 设置动态降级策略，如连续3次失败后切换备用广告源或提示用户检查网络；
4. 定期更新基础库依赖，确保支持最新广告能力；
5. 在灰度发布阶段启用强制广告调试模式，提前暴露配置问题；
6. 与微信团队建立快速响应通道，针对疑似平台侧问题及时反馈；
7. 编写单元测试模拟广告加载失败场景，验证业务逻辑健壮性；
8. 文档化广告接入SOP，减少新成员接入成本；
9. 使用 Webpack 或自定义脚本校验构建时的 adUnitId 注入正确性；
10. 在 CI/CD 流程中加入静态扫描规则，防止硬编码错误ID提交至主干。