Android Studio新建项目Gradle同步失败如何修复？

可以单独下载并配置Gradle来修复你的项目，具体操作步骤如下：

1. 确认项目所需Gradle版本
   打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件，找到distributionUrl字段，从中提取需要的Gradle版本号（例如distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip对应的版本是8.4）。

2. 手动下载对应Gradle版本
   前往Gradle官方下载页面，找到对应版本的bin压缩包（选择bin版而非all版，体积更小）并下载。

3. 配置本地Gradle到项目
   有两种方式可选：

   • 替换Gradle包装器缓存：
     找到本地Gradle缓存目录：Windows系统一般是C:\Users\<你的用户名>\.gradle\wrapper\dists，Mac系统是~/Library/gradle/wrapper/dists。在该目录下找到对应版本的文件夹，将下载并解压后的Gradle文件替换进去；也可直接将下载的压缩包放入该目录，Android Studio会自动完成解压。
   • 在Android Studio中指定本地路径：
     打开File → Settings（Mac为Android Studio → Settings），依次进入Build, Execution, Deployment → Build Tools → Gradle，选择Use local gradle distribution，然后选择你解压后的Gradle文件夹路径，点击应用后同步项目。

4. 额外排查要点

   • 检查Gradle插件与Gradle版本兼容性：项目根目录build.gradle文件中的AGP（Android Gradle Plugin）版本需与Gradle版本匹配（例如Gradle 8.4对应AGP 8.1.x系列）。
   • 确认SDK与JDK路径配置：进入Settings → Appearance & Behavior → System Settings → Android SDK验证SDK路径；进入Settings → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK确认JDK版本（AGP 8.x及以上需使用JDK 17）。
   • 执行清理同步：点击工具栏的Sync Project with Gradle Files按钮，或在终端执行./gradlew clean build（Windows为gradlew clean build）命令。

内容的提问来源于stack exchange，提问作者Nicole Marigold