根本原因是PATH顺序优先于JAVA_HOME，系统按PATH查找java命令，而JAVA_HOME仅被Maven等工具读取；PATH中靠前的旧版java会覆盖JAVA_HOME指向的新版本。
为什么 JAVA_HOME 和 PATH 冲突会导致 java -version 显示错误版本
根本原因在于系统按 PATH 顺序查找可执行文件，而 JAVA_HOME 仅被部分工具（如 Maven、IDE）读取用于定位 JDK 根目录。当 PATH 中存在多个 java 可执行文件（例如 OpenJDK 的 /usr/bin/java 和 Oracle JDK 的 $JAVA_HOME/bin/java），系统优先使用 PATH 中靠前的那个——哪怕 JAVA_HOME 指向的是另一个 JDK。
典型现象：echo $JAVA_HOME 输出 /opt/jdk-17，但 java -version 显示 11；mvn -v 却显示 JDK 17。这就是 PATH 和 JAVA_HOME 不一致的典型表现。
- 检查当前生效的
java路径：which java或command -v java - 确认该路径是否属于你期望的 JDK：
readlink -f $(which java)（Linux/macOS）或where java（Windows CMD） - 查看
PATH中所有含java的路径：echo $PATH | tr ':' '\n' | grep -i java
如何安全地重置 JAVA_HOME 和 PATH（以 Linux/macOS 为例）
不要直接在 ~/.bashrc 或 ~/.zshrc 里硬编码绝对路径并追加到 PATH 开头——这容易掩盖系统级配置或导致 Shell 启动失败。应先清理冗余项，再统一管理。
推荐做法是：只在 Shell 配置中设置 JAVA_HOME，并让 PATH 动态包含 $JAVA_HOME/bin，且确保它位于 PATH 最前面。
立即学习“Java免费学习笔记（深入）”；
export JAVA_HOME=/opt/jdk-17.0.2 export PATH=$JAVA_HOME/bin:$PATH
注意顺序：$JAVA_HOME/bin 必须放在 $PATH 前面，否则旧版本仍会优先命中。执行 source ~/.zshrc 后，立即验证：
-
echo $JAVA_HOME→ 应输出你设定的路径 -
echo $PATH | head -c 50→ 确认开头是/opt/jdk-17.0.2/bin -
java -version和javac -version必须一致
IDE（IntelliJ / Eclipse）和构建工具（Maven / Gradle）为何“不认”系统环境变量
桌面启动的 IDE 通常不继承终端的 Shell 环境变量，尤其是通过图形界面（如 GNOME、Dock）启动时。它们读取的是登录会话或系统级环境配置，而非你修改的 ~/.zshrc。
Maven 和 Gradle 则分两种情况：命令行运行时继承当前 Shell 环境；但 IDE 内嵌运行时，依赖 IDE 自己配置的 JDK 或 JAVA_HOME（如 IntelliJ 的 Project Structure → SDKs）。
- IntelliJ：进入 File → Project Structure → SDKs，确认已添加并选中目标 JDK；同时检查 Build → Build Tools → Maven → Importing → JDK for importer 是否设为同一版本
- Eclipse：打开 Preferences → Java → Installed JREs，勾选目标 JRE，并在项目属性中确认使用的是该 JRE
- Maven：检查
~/.m2/settings.xml中是否有JAVA_HOME；更可靠的方式是在pom.xml中显式指定maven-compiler-plugin的source和target
Windows 下常见的 JAVA_HOME 陷阱
Windows 对路径格式敏感，且注册表、系统属性、用户变量三者可能冲突。最常踩的坑是：JAVA_HOME 指向了 JRE 目录（如 C:\Program Files\Java\jre1.8.0_301），而不是 JDK 目录（如 C:\Program Files\Java\jdk-17.0.2）。JRE 没有 javac.exe 和 bin\jdeps.exe 等开发工具，会导致编译失败但运行正常。
另一个问题是路径含空格且未加引号——虽然 Windows 环境变量本身不支持引号，但某些脚本（如老版 Maven 的 mvn.bat）会因空格解析出错。
- 务必用完整 JDK 路径设置
JAVA_HOME，不能是 JRE - 在“系统属性 → 高级 → 环境变量”中检查：是否存在同名的用户变量和系统变量？用户变量会覆盖系统变量，但仅对当前用户生效
- 验证方式：打开新 CMD（不是已有窗口），运行
echo %JAVA_HOME%和where java，两者应指向同一安装根目录下的bin子目录
真正麻烦的从来不是改一个变量，而是不同层级（Shell、GUI、IDE、CI Agent）各自维护一套 JDK 视图。排查时别只盯着 JAVA_HOME，先锁定哪个进程实际在跑 java，再逆向查它从哪读的路径。
