快捷導(dǎo)航

gradle構(gòu)建工具和java不兼容錯誤的解決方案

更新時間：2025年02月20日 10:57:35 作者：劍客狼心

這篇文章主要介紹了如何解決AS中Gradle和Java版本不兼容的問題,主要解決方案包括升級Gradle版本或降級Java版本,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下

錯誤提示：

AS打開項目根目錄之后，可能會蹦出Your build is currently configured to use incompatible Java 21.0.3 and Gradle 6.7.1. Cannot sync the project.的錯誤提示。

說明gradle構(gòu)建工具和java不兼容，無法同步。

伴隨而來的是系統(tǒng)推薦的解決方案：

We recommend upgrading to Gradle version 8.9.

The minimum compatible Gradle version is 8.5.

The maximum compatible Gradle JVM version is 15.

這個錯誤說明你當(dāng)前的項目配置存在以下問題：

Java 和 Gradle 版本不兼容：
- 你使用的 Java 版本是 21.0.3，而 Gradle 6.7.1 不支持這么高的 Java 版本。
- Gradle 6.7.1 支持的 最高 JVM 版本是 15。
Gradle 版本需要升級：
- 為了解決這個問題，Gradle 需要升級到 至少 8.5 版本，推薦升級到 8.9。
降級java版本

解決方法

方法一：升級 Gradle 版本

（不一定推薦，因為現(xiàn)在企業(yè)主流的jdk還是1.8）

檢查當(dāng)前 Gradle Wrapper 文件：
- 打開項目根目錄下的 gradle/wrapper/gradle-wrapper.properties 文件。
- 找到以下內(nèi)容：

distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip

修改為：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-all.zip

2.更新 Gradle Wrapper：

在終端（Terminal）中運行以下命令：

./gradlew wrapper --gradle-version 8.9

3.同步項目：

在 Android Studio 中點擊 Sync Project with Gradle Files。

方法二：降級 Java 版本

如果你暫時不想升級 Gradle，可以使用一個 Gradle 6.7.1 支持的較低版本的 Java，推薦用java8

通過鏈接下載Java8安裝包Windows x64 Installer 文件（以 .exe 結(jié)尾）。https://www.oracle.com/java/technologies/downloads/#java8提前準(zhǔn)備一個空的文件夾，將exe安裝包內(nèi)的文件放到文件夾內(nèi)。

在你安裝 JDK 1.8 后，通常會有以下幾個文件夾：

jdk-1.8：這是完整的 JDK 安裝目錄，包含 JDK 和 JRE（Java Runtime Environment）。這個文件夾是你安裝 JDK 1.8 后應(yīng)該使用的。
jre1.8.0_441：這是 JRE 安裝目錄，它僅包含 Java 運行時環(huán)境，不包含開發(fā)工具（如編譯器、調(diào)試工具等）。通常，你不需要直接使用這個文件夾來進(jìn)行開發(fā)。
latest：這是 JDK 安裝的最新版本或快捷方式，通?？梢院雎裕攸c使用 jdk-1.8 文件夾。

因此，jdk-1.8 文件夾才是你安裝的 JDK 1.8，你需要將其路徑設(shè)置為 JAVA_HOME。

之后打開AS項目的settings，設(shè)置其Gradle對應(yīng)的JDK版本，選擇手動添加剛剛下載的文件