解决 Java 源发行版 17 与目标发行版不匹配问题

错误

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

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

一、验证 JDK 版本与一致性

1. 安装 JDK 17：
   • 官方下载：Oracle JDK 17
   • 开源替代：Adoptium Temurin 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 SDK 和 Project language level 为 17。
   • Modules > Sources：确保语言级别为 17。
2. 全局设置：
   • File > Settings > Build, Execution, Deployment > Compiler > Java Compiler：设置 Target bytecode version 为 17。