Java项目编译失败多因JDK版本冲突，需统一终端javac/java版本、IDE SDK与语言级别、构建工具（Maven/Gradle）配置及字节码目标版本，再排查多JDK共存干扰。
Java项目突然编译失败、IDE报红、命令行能跑但Maven构建报错，十有八九是JDK版本在暗处打架——javac用的是17，java却调用了8，或IDE绑着11，而Gradle偷偷加载了21。
确认终端真实JDK版本
打开终端，执行：java -version 和 javac -version。两行输出必须完全一致，包括厂商名（如“OpenJDK”“Temurin”）和小版本号（如“17.0.11”）。若不一致，说明PATH中混入了不同JDK的bin目录。
运行 which java 和 which javac，检查路径是否都指向同一JDK安装目录下的bin子目录。如果javac来自/usr/bin/javac，而java来自$JAVA_HOME/bin/java，这就是冲突源头。
【关键前提】 JAVA_HOME必须指向完整JDK（含bin/javac），不能指向JRE；否则javac根本不存在。
立即学习“Java免费学习笔记（深入）”；
检查IDE绑定的SDK与语言级别
IntelliJ IDEA：File → Project Structure → Project → 确认Project SDK和Project language level设为同一版本（如都选“17”）；再点Build → Compiler → Java Compiler → Target bytecode version也必须匹配。
Eclipse：右键项目 → Properties → Java Build Path → Libraries → 选中JRE System Library → Edit → 从列表中选择已安装的正确JDK（不是“Workspace default JRE”）。
VSCode：Ctrl+Shift+P → 输入“Preferences: Open Settings (UI)” → 搜索java.home → 填写JDK根目录绝对路径（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）。
验证构建工具是否被绕过
方法一：Maven项目检查pom.xml中maven-compiler-plugin配置：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>17</source>
<target>17</target>
</configuration>
</plugin>
方法二：Gradle项目检查build.gradle中是否显式声明：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
java {<br> sourceCompatibility = JavaVersion.VERSION_17<br> targetCompatibility = JavaVersion.VERSION_17<br>}
方法三：临时绕过配置验证——在项目根目录执行：mvn compile -Dmaven.compiler.source=17 -Dmaven.compiler.target=17。若成功，说明原配置未生效或被父POM覆盖。
排查多JDK共存干扰
第一步：列出所有已安装JDK（macOS/Linux）：/usr/libexec/java_home -V；Windows执行：dir "%ProgramFiles%\Java\jdk*" /ad /b。
第二步：检查IDE是否在用“Bundled JDK”——IntelliJ中Settings → Build → Execution → Deployment → Console → Shell path，确认未启用“Use IDE JDK for shell”。
第三步：检查Maven是否被IDE劫持——IntelliJ中Settings → Build → Build Tools → Maven → Runner → JRE选项必须选“Project default”，不能是“Bundled (OpenJDK 11)”。
第四步：查看Gradle是否硬编码了java.home——检查项目根目录下gradle.properties是否存在org.gradle.java.home=/path/to/jdk8这类残留配置。
第五步：Windows用户额外检查注册表——运行regedit，定位到HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Development Kit，删除旧版本残留项（如JDK 8条目），避免IDE自动探测错误。
验证字节码版本是否统一
编译后，在target/classes（Maven）或build/classes（Gradle）中找到任意一个.class文件，执行：javap -verbose com.example.Main | grep "major version"。
输出结果对照表：52→JDK 8，55→JDK 11，61→JDK 17，65→JDK 21。该数字必须与你期望的JDK主版本严格对应。
若显示61但你要求JDK 17，正常；若显示55却声称用JDK 17编译，说明maven-compiler-plugin配置未生效或被继承POM覆盖。
