Android Studio项目构建失败：依赖报错排查求助

问题描述 #

今日尝试构建Android Studio项目时触发依赖报错，无法完成构建。未在Module的build.gradle中手动引入报错涉及的依赖，已尝试修改依赖版本为3.0.0、重装Android Studio，问题仍未解决。

排查与解决步骤 #

• 检查项目级build.gradle的仓库配置，确认已添加必要的Maven仓库：

  // 项目根目录build.gradle中的repositories块
  repositories {
      google()
      mavenCentral()
  }
  

• 追踪传递依赖：通过Android Studio自带的依赖分析工具查看间接引入的依赖：
  1. 打开右侧Gradle面板，依次展开项目→Tasks→android→运行androidDependencies任务
  2. 在输出结果中查找报错依赖的来源，找到后可通过exclude排除或强制指定版本：

     implementation('引发问题的依赖') {
         exclude group: '依赖组名', module: '依赖模块名'
     }
     // 或直接强制声明该依赖版本
     implementation '依赖组名:依赖模块名:3.0.0'
     

• 清理Gradle与IDE缓存：
  1. 删除项目根目录下的.gradle文件夹
  2. 打开Android Studio，依次点击File→Invalidate Caches...，勾选Clear file system cache and local history后选择Invalidate and Restart
• 检查代理配置：若使用网络代理，确保Gradle能正常访问远程仓库，可在gradle.properties中调整代理设置；无需代理则删除相关代理配置项

内容的提问来源于stack exchange，提问作者DarkIce Dust