Android Studio 4.2.1 出现未知原因Gradle sync失败如何解决？

适配场景 #

触发sync的前置操作包含新增子模块，且子模块配置与主项目存在差异，常规清理、重装、版本切换操作均无效，故障和依赖/子模块配置相关。

可执行修复步骤 #

• 首先统一全项目SDK版本配置，避免子模块与主项目配置冲突：
  在根项目build.gradle中定义全局统一配置项：

  ext {
      compileSdkVersion = 33 // 替换为你主项目在用的版本号
      minSdkVersion = 21 // 替换为你主项目在用的版本号
      targetSdkVersion = 33 // 替换为你主项目在用的版本号
  }
  

  所有子模块的build.gradle中直接引用全局变量，不要单独写死版本：

  android {
      compileSdk rootProject.ext.compileSdkVersion
      defaultConfig {
          minSdk rootProject.ext.minSdkVersion
          targetSdk rootProject.ext.targetSdkVersion
      }
  }
  

• 定位异常依赖项：
  先注释掉新增模块中所有自定义dependencies配置，触发sync验证是否能成功，如果成功则逐个放开依赖声明，定位导致sync失败的具体依赖包。
• 开启详细日志排查根因：
  打开Android Studio设置，进入Build, Execution, Deployment > Build Tools > Gradle，在「Gradle VM options」输入框中添加参数 -Dorg.gradle.logging.level=debug，重新触发sync后，通过Help > Show Log in Explorer（Windows）/Help > Show Log in Finder（Mac）打开日志文件，搜索报错栈信息定位具体故障点。
• 清理损坏的依赖缓存：
  进入本地maven缓存目录（默认路径为C:\Users\你的用户名\.gradle\caches（Windows）/~/.gradle/caches（Mac/Linux）），删除对应版本的依赖缓存文件后重新触发sync拉取。

内容的提问来源于stack exchange，提问作者Karthik M