父组件重建时，如何确保InterstitialAd插屏广告仅触发一次？

方案1：在InterstitialAd内部用标志位+initState控制单次展示 #

利用initState仅在组件初始化时执行一次的特性，配合布尔标志位确保广告只加载并展示一次，彻底避免组件重建带来的重复触发。

• 实现步骤：
  1. 在组件状态类中添加私有变量bool _hasAdShown = false;，标记广告是否已展示。
  2. 在initState中初始化广告加载逻辑，加载完成后判断标志位，未展示则触发展示并将标志位设为true。
  3. 后续组件重建时，initState不会重复执行，且标志位已标记为已展示，不会再次触发广告。

代码示例：

class InterstitialAd extends StatefulWidget {
  const InterstitialAd({super.key});

  @override
  State<InterstitialAd> createState() => _InterstitialAdState();
}

class _InterstitialAdState extends State<InterstitialAd> {
  bool _hasAdShown = false;
  GoogleMobileAdsInterstitialAd? _interstitialAd;

  @override
  void initState() {
    super.initState();
    _loadInterstitialAd();
  }

  void _loadInterstitialAd() {
    GoogleMobileAdsInterstitialAd.load(
      adUnitId: 'your_ad_unit_id',
      request: const AdRequest(),
      adLoadCallback: GoogleMobileAdsInterstitialAdLoadCallback(
        onAdLoaded: (ad) {
          _interstitialAd = ad;
          if (!_hasAdShown) {
            _showAd();
            _hasAdShown = true;
          }
        },
        onAdFailedToLoad: (error) {
          // 可选：添加最多3次的重试逻辑，避免单次加载失败
        },
      ),
    );
  }

  void _showAd() {
    _interstitialAd?.show();
    // 广告关闭后销毁实例，防止内存泄漏
    _interstitialAd?.fullScreenContentCallback = FullScreenContentCallback(
      onAdDismissedFullScreenContent: (ad) => ad.dispose(),
    );
  }

  @override
  void dispose() {
    _interstitialAd?.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return const SizedBox.shrink(); // 插屏广告无需UI占位
  }
}

方案2：全局单例广告管理器分离业务逻辑 #

将广告的加载、展示逻辑从组件中抽离，封装成全局单例的AdManager类，统一管理广告状态，彻底摆脱组件重建的影响。

• 实现步骤：
  1. 创建单例AdManager类，内部维护广告实例和展示标志位。
  2. 提供showInterstitialAd方法，内部判断广告是否已加载且未展示，满足条件则触发展示。
  3. 父组件或InterstitialAd组件只需调用AdManager.instance.showInterstitialAd()，无需关心组件重建问题。

代码示例：

class AdManager {
  static final AdManager _instance = AdManager._internal();
  factory AdManager() => _instance;
  AdManager._internal();

  bool _hasInterstitialShown = false;
  GoogleMobileAdsInterstitialAd? _interstitialAd;

  void showInterstitialAd() {
    if (_hasInterstitialShown) return;

    if (_interstitialAd != null) {
      _interstitialAd!.show();
      _hasInterstitialShown = true;
      _setupAdDispose();
      return;
    }

    // 广告未加载时先加载再展示
    GoogleMobileAdsInterstitialAd.load(
      adUnitId: 'your_ad_unit_id',
      request: const AdRequest(),
      adLoadCallback: GoogleMobileAdsInterstitialAdLoadCallback(
        onAdLoaded: (ad) {
          _interstitialAd = ad;
          ad.show();
          _hasInterstitialShown = true;
          _setupAdDispose();
        },
        onAdFailedToLoad: (error) {
          // 处理加载失败逻辑
        },
      ),
    );
  }

  void _setupAdDispose() {
    _interstitialAd?.fullScreenContentCallback = FullScreenContentCallback(
      onAdDismissedFullScreenContent: (ad) {
        ad.dispose();
        _interstitialAd = null;
      },
    );
  }
}

// 在父组件或InterstitialAd中调用
// AdManager.instance.showInterstitialAd();

方案3：使用AutomaticKeepAliveClientMixin保持组件状态 #

通过AutomaticKeepAliveClientMixin让InterstitialAd组件在父组件重建时保留自身状态，避免重复初始化广告。

• 实现步骤：
  1. 让InterstitialAd的状态类混入AutomaticKeepAliveClientMixin。
  2. 重写wantKeepAlive方法返回true，告诉框架需要保持组件状态。
  3. 在build方法中必须调用super.build(context)，否则状态不会被保留。

代码示例：

class InterstitialAd extends StatefulWidget {
  const InterstitialAd({super.key});

  @override
  State<InterstitialAd> createState() => _InterstitialAdState();
}

class _InterstitialAdState extends State<InterstitialAd> with AutomaticKeepAliveClientMixin {
  bool _hasAdShown = false;
  GoogleMobileAdsInterstitialAd? _interstitialAd;

  @override
  bool get wantKeepAlive => true;

  @override
  void initState() {
    super.initState();
    _loadInterstitialAd();
  }

  void _loadInterstitialAd() {
    // 同方案1的加载、展示逻辑
  }

  @override
  Widget build(BuildContext context) {
    super.build(context); // 必须调用，否则状态无法保留
    return const SizedBox.shrink();
  }
}

注意事项 #

• 广告加载失败时，建议添加有限次数的重试逻辑（如最多3次），避免无限重试消耗资源。
• 广告展示完毕或组件销毁时，务必调用ad.dispose()释放资源，防止内存泄漏。
• 若需要在特定场景下重复展示广告（如用户再次进入启动页），可重置标志位，但需控制展示频率，避免影响用户体验。

内容的提问来源于stack exchange，提问作者Stéphane de Luca