Java版本冲突源于多JDK共存及项目、构建工具、IDE配置不一致；需统一JDK安装与JAVA_HOME，配置构建工具编译版本，IDE中独立设置SDK与语言级别，并通过命令行和字节码验证确保各环节版本一致。
Java环境搭建时版本冲突主要源于系统中存在多个JDK，或项目配置、构建工具（如Maven、Gradle）、IDE（如IntelliJ、Eclipse）各自引用了不同版本的JDK。避免冲突的关键在于统一管理JDK路径、明确优先级，并让各环节“看到同一套Java”。
统一JDK安装与环境变量配置
只保留一个主用JDK（推荐LTS版本，如JDK 17或JDK 21），卸载或移除其他冗余JDK。安装后严格配置JAVA_HOME指向该JDK根目录（如/usr/lib/jvm/jdk-17.0.1或C:\Program Files\Java\jdk-17.0.1），并确保PATH中%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（Linux/macOS）排在最前。
- 执行java -version和javac -version确认输出一致且符合预期
- 避免在PATH中直接写死某JDK的绝对路径（如/opt/java8/bin），否则会绕过JAVA_HOME控制
- macOS用户注意：/usr/bin/java是系统符号链接，实际由/usr/libexec/java_home管理，建议用它切换（如export JAVA_HOME=$(/usr/libexec/java_home -v 17)）
构建工具需显式声明Java版本
Maven和Gradle默认可能沿用系统Java，但项目本身有兼容性要求（如Spring Boot 3.x要求JDK 17+），必须主动约束。
-
Maven：在pom.xml中配置maven-compiler-plugin，指定source和target（或release）：
org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17 -
Gradle：在build.gradle中设置：
java { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_17 } - 使用mvn -v或gradle --version检查其运行时Java路径是否与项目所需一致
IDE中独立配置SDK与项目语言级别
IDE（如IntelliJ、Eclipse）自带JDK配置逻辑，不依赖系统环境变量。即使系统Java已更新，IDE仍可能沿用旧SDK，导致编译/运行结果不一致。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：进入File → Project Structure → Project，设置Project SDK和Project language level；同时检查模块（Modules）和全局SDK列表，移除不用的JDK
- Eclipse：右键项目→Properties → Java Build Path → Libraries，确认JRE System Library为正确版本；再进入Java Compiler页签启用Enable project specific settings并设好编译器合规性
- 启动IDE时若提示“JDK not found”，说明IDE自身配置未同步，不要跳过，务必手动指定
排查与验证冲突的常用手段
当出现“Unsupported class file major version”、“java.lang.UnsupportedClassVersionError”或编译通过但运行报错时，大概率是版本不匹配。按以下顺序快速定位：
- 终端中分别运行which java、which javac、echo $JAVA_HOME，确认三者指向一致
- 在IDE内打开Terminal，执行java -version——这反映IDE启动时加载的Java，而非系统默认
- Maven项目：运行mvn help:effective-pom | grep -A 5 "maven-compiler-plugin"，查看实际生效的编译配置
- 检查target/classes（Maven）或build/classes（Gradle）中.class文件的版本号，可用javap -verbose YourClass.class | grep version，对照JVM规范版本映射表
