Java版本冲突源于系统、构建工具和IDE引用不同JDK；解决关键是统一JAVA_HOME、PATH、构建工具配置及IDE SDK，确保各环节指向同一JDK路径与版本，并通过java -version、javac -version、mvn -version及字节码验证（如javap -v）确认一致性。
Java安装后出现版本冲突，核心在于系统、构建工具和IDE各自“看到”的JDK不一致。解决的关键不是重装，而是让所有环节对齐到同一个JDK路径和版本。
确认当前实际生效的Java版本
先搞清楚你命令行里跑的是哪个Java：
- 执行 java -version 和 javac -version，看输出是否一致、是否是你想用的版本（比如JDK 17）
- 运行 where java（Windows）或 which java（macOS/Linux），确认java.exe/javac的实际路径
- 检查 echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux），看它是否指向你期望的JDK根目录
统一环境变量与JDK路径
JAVA_HOME必须准确，PATH必须优先使用它：
- 只保留一个主用JDK（推荐LTS版，如JDK 17或JDK 21），卸载其他冗余JDK（尤其注意Windows上带“x86”“32-bit”的条目）
- 设置JAVA_HOME为JDK安装根目录，例如：
C:\Program Files\Java\jdk-17.0.1 或 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home - 把 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）放在PATH最前面，删掉PATH中任何硬编码的java路径（如C:\Program Files (x86)\Java\...）
- macOS用户建议用 /usr/libexec/java_home -v 17 动态获取路径，避免写死
同步构建工具与IDE配置
命令行正确 ≠ Maven/Gradle/IDE也正确：
立即学习“Java免费学习笔记（深入）”；
- Maven：检查 mvn -version 输出的Java版本；若不对，确保它读取的是正确的JAVA_HOME（不要在
settings.xml里覆盖） - Gradle：在
gradle.properties中可设org.gradle.java.home，但更推荐靠JAVA_HOME驱动 - IntelliJ：进 File → Project Structure → Project，确认Project SDK和Project language level匹配；再检查每个模块的
Modules → Sources里Language level - Eclipse：进 Preferences → Java → Installed JREs，勾选目标JDK；再右键项目 → Properties → Java Build Path → Libraries，替换JRE System Library
验证字节码兼容性
即使环境显示正常，仍可能因编译目标不一致报错（如UnsupportedClassVersionError）：
- Maven项目：在
pom.xml中明确指定编译级别：<maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target> - Gradle项目：在
build.gradle中设置：java { sourceCompatibility = JavaVersion.VERSION_17; targetCompatibility = JavaVersion.VERSION_17 } - 编译后可用
javap -v YourClass.class | grep major查看实际字节码版本（55=Java 11，61=Java 17，65=Java 21）
