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

错误

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

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

一、验证JDK版本与一致性

1. 检查已安装的JDK版本：

   java-versionjavac-version

   确保输出显示JDK 17（如17.0.11）。若版本低于17，需安装JDK 17。

2. 验证构建工具使用的JDK：

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

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

3. 安装JDK 17：

   • 官方下载：Oracle JDK 17
   • 开源替代：Adoptium Temurin JDK 17

二、修复构建工具配置

Maven项目

1. 统一版本声明：

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

2. 更新编译器插件：

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

3. 检查父项目依赖：

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

Gradle项目

1. 配置Java工具链：

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

2. 显式设置兼容性：

   tasks.withType(JavaCompile){sourceCompatibility=17targetCompatibility=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 SDK和Project language level为17。
   • Modules > Sources：确保语言级别为17。

2. 全局设置：

   • File > Settings > Build, Execution, Deployment > Compiler > Java Compiler：设置Target bytecode version为17。