解决Android Studio中':app:checkDebugAarMetadata'任务执行失败问题

核心修复步骤 #

• 补全依赖版本号
  打开模块级app/build.gradle文件，找到dependencies块中的com.google.firebase:firebase-analytics声明，补充有效版本号，示例：

  implementation 'com.google.firebase:firebase-analytics:21.5.0'
  

  版本号可根据Firebase最新稳定版调整。

• 使用Firebase BOM统一管理版本
  若项目包含多个Firebase组件，推荐在dependencies块顶部引入Firebase BOM，自动适配兼容版本，无需单独指定firebase-analytics版本：

  implementation platform('com.google.firebase:firebase-bom:32.7.0')
  implementation 'com.google.firebase:firebase-analytics'
  

• 清理缓存并重新同步

  1. 点击顶部工具栏File > Sync Project with Gradle Files
  2. 执行Build > Clean Project后再执行Build > Rebuild Project
  3. 可手动删除项目根目录下的.gradle文件夹和app/build文件夹，再重新同步

• 检查Google Maven仓库配置
  确保项目级build.gradle的repositories块中包含Google仓库：

  repositories {
      google()
      mavenCentral()
  }
  

• 验证Firebase插件配置
  项目级build.gradle的dependencies块需包含Firebase插件依赖：

  dependencies {
      classpath 'com.google.gms:google-services:4.4.0'
  }
  

  同时模块级app/build.gradle末尾需应用插件：

  apply plugin: 'com.google.gms.google-services'
  

进阶调试命令 #

若以上方法无效，在Android Studio终端执行以下命令获取详细错误信息：

• 获取堆栈跟踪：./gradlew :app:checkDebugAarMetadata --stacktrace
• 查看详细日志：./gradlew :app:checkDebugAarMetadata --info
• 完整构建分析：./gradlew :app:checkDebugAarMetadata --scan

内容的提问来源于stack exchange，提问作者Mou Das