java: 警告: 源发行版 17 需要目标发行版 17

错误

java: 警告: 源发行版 17 需要目标发行版 17
在这里插入图片描述

要解决“java: 无效的目标发行版: 17”错误,需从JDK版本、构建工具配置、环境变量、IDE设置、依赖兼容性五个维度系统性排查。以下是具体步骤和解决方案:

一、验证JDK版本与一致性

  1. 安装JDK 17

验证构建工具使用的JDK

mvn -v# Maven使用的JDK版本 gradle -v# Gradle使用的JDK版本

确保与项目配置的JDK 17一致。

检查已安装的JDK版本

java-version javac -version

确保输出显示JDK 17(如17.0.11)。若版本低于17,需安装JDK 17。

二、修复构建工具配置

Maven项目

检查父项目依赖

<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.1.0</version><!-- 支持JDK 17的版本 --></parent>

更新编译器插件

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.11.0</version><!-- 支持JDK 17的最低版本 --></plugin></plugins></build>

统一版本声明

<properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><maven.compiler.release>17</maven.compiler.release><!-- 推荐使用release标志 --></properties>
Gradle项目

显式设置兼容性

tasks.withType(JavaCompile){ sourceCompatibility =17 targetCompatibility =17}

配置Java工具链

java { toolchain { languageVersion = JavaLanguageVersion.of(17)}}

三、检查环境变量

  1. JAVA_HOME
    • 指向JDK 17安装目录(如C:\Program Files\Java\jdk-17)。
    • 验证:终端执行echo %JAVA_HOME%(Windows)或echo $JAVA_HOME(Linux/macOS)。
  2. PATH
    • 包含%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(Linux/macOS)。

四、IDE配置检查

IntelliJ IDEA
  1. 项目设置
    • File > Project Structure > Project:设置Project SDKProject language level17
    • Modules > Sources:确保语言级别为17
  2. 全局设置
    • File > Settings > Build, Execution, Deployment > Compiler > Java Compiler:设置Target bytecode version17
Could not load content