Java版本不一致怎么解决？

Java开发中环境不一致——尤其是javac与java版本错配——绝非表面问题，而是埋藏在构建、运行和CI流程中的定时炸弹：看似编译通过的var、record等新特性，上线即抛UnsupportedClassVersionError；IDE显示正常却实际用错JDK；Homebrew多版本切换混乱；CI镜像默认配置陷阱……本文直击根源，从终端PATH优先级、JAVA_HOME校验、IDE项目级SDK配置、Gradle/MAVEN工具链对齐，到Docker镜像选型和CI脚本强制锁定，提供全链路可落地的版本对齐方案，帮你终结“本地能跑、线上爆炸”的玄学故障。

javac 和 java 版本不一致时，java -version 和 javac -version 输出不同怎么办

直接看输出结果：如果 java -version 显示 17，而 javac -version 显示 11，说明编译器和运行时用的是两套 JDK。这不是“看起来奇怪”，而是真会出问题——比如用了 var 或 record 编译通过，运行时报 UnsupportedClassVersionError。

根本原因通常是 PATH 中多个 JDK 混杂，或 IDE（如 IntelliJ）手动指定了 JRE 而非 JDK，或系统变量 JAVA_HOME 指向了旧 JDK，但 shell 的 PATH 里又优先加载了另一个 bin 目录。

• 先执行 which java 和 which javac（macOS/Linux）或 where java 和 where javac（Windows），确认它们是否来自同一目录
• 检查 JAVA_HOME 是否设置，且该路径下的 bin/java 和 bin/javac 都存在
• 确保 PATH 中 $JAVA_HOME/bin（或等效路径）排在其他 JDK 的 bin 前面

IntelliJ / Eclipse 里显示 JDK 版本对不上，但终端里是对的

IDE 不读系统 PATH 或 JAVA_HOME，它用自己的项目配置。终端里版本对了，不代表 IDE 编译/运行用的也是它。

• IntelliJ：进 File → Project Structure → Project，确认 Project SDK 和 Project language level 一致；再检查 Run → Edit Configurations → JRE 是否选了同个 SDK
• Eclipse：右键项目 → Properties → Java Build Path → Libraries，展开 JRE System Library，确认是“Workspace default JRE”或明确指向你想要的 JDK；同时检查 Java Compiler 页面的 Compiler compliance level 是否匹配
• Gradle 项目还要看 gradle.properties 里的 org.gradle.java.home，以及 build.gradle 中 java.toolchain.version（Gradle 17+）是否与本地一致

Mac 上用 Homebrew 装了多个 JDK，javac 总调用错版本

Homebrew 安装的 JDK（如 openjdk@17、openjdk@21）默认不会改全局链接，/usr/bin/javac 可能仍是系统残留的旧版。

• 别依赖 /usr/bin/java，它只是代理，行为不可控；始终用 $JAVA_HOME/bin/java
• 用 brew unlink openjdk@11 && brew link openjdk@17 切换默认链接（注意：link 前确保没其他 JDK 正在被 link）
• 更稳妥的方式：在 shell 配置（~/.zshrc）里显式写死 export JAVA_HOME=$(/usr/libexec/java_home -v 17)，然后 export PATH=$JAVA_HOME/bin:$PATH
• /usr/libexec/java_home -V 可列出所有已注册 JDK，注意它识别的是 /Library/Java/JavaVirtualMachines/ 下的完整安装，不是 Homebrew 的 symlink 目录

Linux 或 CI 环境中脚本里 java 和 javac 版本漂移

CI（如 GitHub Actions、GitLab CI）常复用基础镜像，里面可能预装多个 JDK，且 update-alternatives 或环境变量未清理干净。

• CI 脚本开头强制指定：用 export JAVA_HOME=/opt/java/jdk-17.0.1 + export PATH=$JAVA_HOME/bin:$PATH，别信 sudo update-alternatives --config java 的交互式选择
• Docker 构建时，避免用 openjdk:latest，改用带小版本号的 tag，例如 openjdk:17-jdk-slim；JDK 镜像里 java 和 javac 天然同源，不会错位
• Shell 脚本里不要只写 java -cp ... Main，加个前置校验：if [ "$($JAVA_HOME/bin/java -version 2>&1 | head -1 | cut -d' ' -f 3 | tr -d '"')" != "17.0.1" ]; then echo "JDK mismatch"; exit 1; fi

最麻烦的不是版本不对，而是某些构建工具（比如 Maven 的 maven-compiler-plugin）允许 source 和 target 设成 17，但底层 javac 实际是 11——它会静默降级编译，直到运行时报错才暴露。这种隐性错位，比直接报错更难排查。

以上就是《Java版本不一致怎么解决？》的详细内容，更多关于的资料请关注golang学习网公众号！