Flutter：AdWidget已在Widget树中异常的解决与含义解析

异常含义 #

This AdWidget is already in the Widget tree 表示同一个广告对象对应的AdWidget实例被重复添加到了Flutter Widget树中。Google Mobile Ads SDK的设计规则是：单个BannerAd（或其他广告类型）对象只能绑定一个AdWidget，且该AdWidget只能存在于一处Widget树节点里。当你从HomeFeedPage跳转到下一页后，旧页面的AdWidget并未完全从Widget树中移除，新页面又尝试使用同一个全局共享的广告对象创建并添加AdWidget，就会触发这个错误。

正确处理方案（不建议禁用异常） #

禁用异常只是治标不治本，可能引发广告展示异常或内存泄漏，推荐从广告生命周期管理入手解决：

1. 避免全局共享单个广告实例 #

不要用同一个AdaptiveBannerAdProvider为多个页面提供广告对象，改为每个页面独立创建广告实例，或者在Provider中为不同页面维护独立的广告对象池。

2. 完善广告销毁逻辑 #

修改AdaptiveBannerAdProvider的disposeAd方法，销毁广告后必须将实例置空，防止后续复用已绑定过的对象：

void disposeAd() {
  _anchoredAdaptiveAd?.dispose();
  _anchoredAdaptiveAd = null; // 置空实例，避免后续复用
  _isLoaded = false;
  notifyListeners();
}

3. 加载新广告前清理旧实例 #

在loadAnchoredAdaptiveAd方法开头，先检查并销毁已存在的广告实例，再创建新的广告：

Future<void> loadAnchoredAdaptiveAd(BuildContext context) async {
  // 先清理旧广告
  if (_anchoredAdaptiveAd != null) {
    _anchoredAdaptiveAd!.dispose();
    _anchoredAdaptiveAd = null;
    _isLoaded = false;
  }

  // 原有的广告加载逻辑...
}

4. 页面跳转时确保旧广告已销毁 #

在页面dispose时，除了调用disposeAd，还要确保Provider中的广告状态已重置，避免新页面复用旧状态。

临时禁用异常（不推荐） #

如果需要临时绕过该检查，可在初始化Mobile Ads时添加配置，但此操作可能导致广告展示问题：

MobileAds.instance.initialize().then((_) {
  MobileAds.instance.updateRequestConfiguration(RequestConfiguration(
    // 其他配置...
    customTargeting: {'disable_ad_widget_check': 'true'},
  ));
});

内容的提问来源于stack exchange，提问作者Usama Sadiq