Java 编译报错：源发行版 17 需要目标发行版 17 排查指南

统一版本声明 推荐使用 release 标志来同时指定源和目标版本，避免冲突：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
    <maven.compiler.release>17</maven.compiler.release>
</properties>

Gradle 项目

显式设置兼容性 在 build.gradle 中强制指定 Java 版本：

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

配置 Java 工具链 更推荐的方式是配置工具链，让 Gradle 自动管理 JDK：

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

三、检查环境变量

环境变量配置错误是导致版本错乱的常见原因。

1. JAVA_HOME：
   • 必须指向 JDK 17 的安装目录（例如 C:\Program Files\Java\jdk-17 或 /usr/lib/jvm/java-17-openjdk）。
   • 验证方法：终端执行 echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（Linux/macOS）。
2. PATH：
   • 确保包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Linux/macOS），以便命令行能调用正确的 java 和 javac。

四、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。
   • 修改完成后，建议重启 IDE 或重新导入项目以确保配置生效。

搞定以上步骤后，重新编译项目，通常就能解决这个警告了。如果问题依旧，记得检查一下是否有第三方库强制指定了旧版本的 Java 特性。