Flutter集成Admob时应用崩溃，基础配置后未加广告代码仍报错

我之前在集成Admob的时候也踩过一模一样的坑——哪怕还没写任何广告代码，光配置完依赖和Manifest就崩了，给你几个亲测有效的解决步骤：

1. 彻底清理构建缓存和临时文件 #

这是解决这类Gradle缓存冲突最直接的办法：

• 先关掉正在运行的应用，在项目根目录执行：

  flutter clean
  

• 进入项目的android子目录，执行Gradle清理命令：

  # macOS/Linux系统
  ./gradlew clean
  
  # Windows系统
  gradlew clean
  

• 回到根目录重新获取依赖并构建：

  flutter pub get
  flutter run
  

2. 确认AndroidManifest配置的正确性 #

虽然你已经添加了meta-data，但还是要再检查两个容易出错的细节：

• 确保com.google.android.gms.ads.APPLICATION_ID的值是Admob后台的应用ID，不是广告单元ID（很多人会搞混），格式是ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy
• 确认meta-data标签是放在<application>标签内部的，不能放在外面，正确结构示例：

  <application ...>
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="你的Admob应用ID"/>
    <!-- 其他activity、service等配置 -->
  </application>
  

3. 更新Gradle和Google服务插件版本 #

旧版本的Gradle或Google服务插件可能和Admob SDK存在兼容性问题：

• 打开android/build.gradle文件，更新google-services插件版本到最新稳定版，比如：

  dependencies {
      classpath 'com.google.gms:google-services:4.3.15'
      // 其他classpath配置
  }
  

• 打开android/gradle/wrapper/gradle-wrapper.properties，更新Gradle版本到7.x以上的稳定版，比如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

4. 临时禁用构建缓存（应急方案） #

如果上面的方法都没效果，可以尝试在运行时跳过构建缓存：

flutter run --no-build-cache

这个方法只是临时解决，后续还是建议通过前面的步骤修复缓存问题，不然每次构建都会变慢。

问题原因说明 #

你遇到的mergeDebugNativeLibs任务失败，本质是Gradle的构建缓存文件损坏或冲突了——当引入Admob这类包含Native库的依赖时，Gradle缓存的zip文件可能出现丢失或版本不匹配，清理缓存就能让Gradle重新生成正确的构建文件。

内容的提问来源于stack exchange，提问作者Ahmed Wagdi