新安装Android Studio 2024.1.2.12后Gradle版本矛盾错误求助

问题描述 #

创建空活动项目后，出现两处完全矛盾的Gradle错误提示：

Error: "Unsupported Gradle Version"
Error Description: "Failed to get a Gradle version. This could happen because of invalid or outdated Gradle wrapper. We recommend upgrading to Gradle version 8.5. Possible solution: - Upgrade to Gradle 8.5 and re-sync"

Error: "Gradle Sync Issues"
Error Description: "Minimum supported Gradle version is 8.7. Current version is 8.5. Please fix the project's Gradle settings. Change Gradle version in Gradle wrapper to 8.7 and re-import project Open Gradle wrapper properties Gradle Settings."

已确认项目结构中Gradle版本设为8.7，gradle-wrapper.properties的distributionUrl指向gradle-8.7-bin.zip，但问题仍未解决。

解决步骤 #

1. 强制清理缓存并重启Android Studio #

• 关闭Android Studio
• 删除本地Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS：/Users/<你的用户名>/.gradle/caches
  • Linux：/home/<你的用户名>/.gradle/caches
• 重新打开AS，点击菜单栏File → Invalidate Caches...，勾选所有选项后点击Invalidate and Restart

2. 手动核对所有Gradle配置文件 #

• 打开项目根目录的build.gradle（Project级），检查classpath对应的AGP版本是否与Gradle 8.7兼容：

  dependencies {
      classpath "com.android.tools.build:gradle:8.1.2" // Gradle 8.7适配AGP 8.1.0~8.3.x版本
  }
  

• 再次确认gradle/wrapper/gradle-wrapper.properties的配置：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
  

• 打开settings.gradle，排查是否存在异常的仓库或插件引用

3. 重新同步项目 #

• 点击AS右上角的Sync Project with Gradle Files按钮
• 若同步时提示下载Gradle，等待下载完成后再次执行同步

4. 检查Android Studio完整性 #

• 打开File → Settings → Appearance & Behavior → System Settings → Updates，安装AS的补丁更新后重启
• 若问题依旧，卸载当前AS后重新下载官方最新版安装

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