Gradle从哪个版本开始支持Java 17？配置项目报错如何解决

报错说明 #

你遇到的版本不兼容报错内容如下：

不支持的Java版本。您的构建当前配置为使用Java 17.0.1和Gradle 7.0。

Gradle正式支持Java 17的最低版本 #

Gradle从 7.3版本 开始正式支持Java 17作为运行时环境与编译目标版本，7.3之前的Gradle版本均未完成Java 17的兼容适配，这是触发当前报错的核心原因。

解决方案 #

• 方案1：升级Gradle版本（推荐）
  直接将项目Gradle版本升级到7.3及以上即可兼容Java 17，修改项目下gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl参数即可完成配置，示例如下：

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

  也可以通过wrapper命令完成升级：类Unix环境执行./gradlew wrapper --gradle-version 7.6.3，Windows环境执行gradlew.bat wrapper --gradle-version 7.6.3。

• 方案2：降级项目使用的Java版本
  若暂时无法升级Gradle版本，可将项目使用的Java版本降级到Gradle 7.0支持的范围，最高可使用Java 16，也可选择兼容性更稳定的LTS版本Java 11。

• 方案3：配置Gradle Java工具链
  若本地安装了多个Java版本，可直接在项目的build.gradle中显式指定编译使用的Java版本，无需修改全局Java配置，Groovy语法示例如下：

  java {
      toolchain {
          languageVersion.set(JavaLanguageVersion.of(11))
      }
  }
  

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