Flutter集成Google Mobile Ads报MissingPluginException异常如何解决

错误核心原因 #

报错提示No implementation found for method loadBannerAd，本质是Google Mobile Ads的原生端实现没有被正确注册到Flutter通信通道。你之前执行的flutter clean、flutter pub get没有解决问题，大概率是触发了两类问题：一是新增原生插件后未执行全量构建，仅用热重载/热重启启动应用；二是原生端配置缺失、Dart层SDK初始化顺序错误。

分步解决 #

• 第一步：全量重新构建应用
  新增原生平台插件后，Flutter的热重载、热重启都不会加载新编译的原生代码，必须先完全关闭当前调试的应用进程，重新执行flutter run命令完整编译安装包，90%的同类问题执行这一步就能解决。
• 第二步：补全原生端必要配置
  • 安卓端：打开android/app/src/main/AndroidManifest.xml，在<application>标签内添加AdMob应用ID元数据，替换为你自己在AdMob后台申请的App ID：

    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-你的实际应用ID"/>
    

  • iOS端：打开ios/Runner/Info.plist，添加SDK初始化需要的应用ID配置：

    <key>GADApplicationIdentifier</key>
    <string>ca-app-pub-你的实际应用ID</string>
    

• 第三步：修正Dart层代码逻辑问题
  你当前的代码存在两个问题：一是SDK初始化是异步操作，没有等待初始化完成就直接加载广告；二是initState里先执行异步初始化再调用super.initState不符合Flutter生命周期规范，另外dispose里的_controller!强制空安全写法容易触发空指针。修正后的完整代码如下：

  bool _isBannerAdReady = false;
  late BannerAd _bannerAd;
  
  @override
  void initState() {
    super.initState();
    _loadBannerAd();
  }
  
  Future<void> _loadBannerAd() async {
    // 等待SDK初始化完成再执行广告加载
    await MobileAds.instance.initialize();
  
    _bannerAd = BannerAd(
      adUnitId: AdHelper.bannerAdUnitId,
      request: const AdRequest(),
      size: AdSize.banner,
      listener: BannerAdListener(
        onAdLoaded: (_) {
          setState(() {
            _isBannerAdReady = true;
          });
        },
        onAdFailedToLoad: (ad, err) {
          print('Banner ad load failed: ${err.message}');
          _isBannerAdReady = false;
          ad.dispose();
        },
      ),
    );
  
    _bannerAd.load();
  }
  
  @override
  void dispose() {
    // 用可空调用避免_controller未初始化时抛错
    _controller?.dispose();
    _bannerAd.dispose();
    super.dispose();
  }
  

• 极端情况缓存清理
  如果以上步骤执行完还是报错，执行以下命令彻底清理多端缓存后重新构建：

  flutter clean
  # 清理安卓构建缓存
  cd android && ./gradlew clean
  # 清理iOS依赖缓存
  cd ../ios && pod deintegrate && pod install --repo-update
  cd .. && flutter pub get
  flutter run
  

内容的提问来源于stack exchange，提问作者keta kay