JAVA_HOME 指向哪个目录才真正有效
必须指向 JDK 的根目录，不是 JRE 目录，也不是 bin 子目录。常见错误是把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17.0.1\bin —— 这会导致几乎所有依赖它的工具（如 Maven、Gradle、IDE）报“找不到 Java”或“java.lang.NoClassDefFoundError”。JDK 根目录下得有 lib、jre（或 conf）、bin 三个关键子目录。
- ✅ 正确示例：
C:\Program Files\Java\jdk-17.0.1（Windows）或/usr/lib/jvm/java-17-openjdk-amd64（Linux） - ❌ 错误示例：
C:\...\jdk-17.0.1\bin、C:\...\jre1.8.0_301、/opt/java（软链接未解析到真实 JDK 路径） - 验证方法：在终端执行
$JAVA_HOME/bin/java -version，能正常输出版本即说明路径可访问；再检查ls $JAVA_HOME/lib/tools.jar（JDK 8）或$JAVA_HOME/lib/jrt-fs.jar（JDK 9+），存在才代表是完整 JDK
Windows 下设置 JAVA_HOME 后命令行仍不识别 java 命令
这是路径配置断层问题：JAVA_HOME 只是环境变量，java 命令能否运行取决于 PATH 是否包含 %JAVA_HOME%\bin。很多人只设了 JAVA_HOME，忘了同步更新 PATH。
- 必须手动把
%JAVA_HOME%\bin加入系统 PATH（不是用户 PATH，除非你只在当前账户用） - 修改后需重启所有已打开的命令行窗口（CMD/PowerShell/Terminal），旧窗口不会自动继承新环境变量
- 验证顺序：先
echo %JAVA_HOME%确认值正确，再where java查看是否命中%JAVA_HOME%\bin\java.exe；如果返回多个结果，说明 PATH 里混进了其他 JDK 或 JRE 的bin，要清理
Linux/macOS 中 /etc/profile 与 ~/.bashrc 设置 JAVA_HOME 的区别
根本区别在于加载时机和作用范围：/etc/profile 影响所有用户和所有 shell 登录会话（包括 SSH 登录、GUI 终端启动的 bash），而 ~/.bashrc 只影响当前用户的交互式非登录 shell（比如 GNOME Terminal 里新开的 tab）。很多 IDE（如 IntelliJ）或 CI 工具（如 Jenkins agent）启动时走的是非登录 shell，只读 ~/.bashrc —— 如果你只改了 /etc/profile，它们就看不到 JAVA_HOME。
- 推荐做法：在 ~/.bashrc（或 ~/.zshrc）中设置
export JAVA_HOME=/usr/lib/jvm/jdk-17.0.1和export PATH=$JAVA_HOME/bin:$PATH，然后执行source ~/.bashrc - 避免在 /etc/environment 中写 JAVA_HOME（Debian/Ubuntu 系），它不支持变量展开，
$HOME或$PATH都无法解析 - systemd 服务（如自建的 Java 后台进程）默认不读 shell 配置文件，需在 service 文件里显式定义
Environment="JAVA_HOME=/path/to/jdk"
Maven/Gradle 报错 “Could not determine java version from 'xx.x.x'”
这不是 JAVA_HOME 配错了，而是构建工具调用的 java 命令版本和它自身兼容性不匹配。典型如 Gradle 7.x 要求 JDK 11+，但 PATH 里优先找到了系统自带的 JDK 8；或者 Maven 尝试解析 java -version 输出时被中文 locale 干扰（如显示“版本 1.8.0_301”而非“1.8.0_301”）。
立即学习“Java免费学习笔记（深入）”；
- 检查实际被调用的 java：
which java+java -version，确认输出格式干净、版本符合工具要求 - 临时覆盖：运行
JAVA_HOME=/path/to/jdk17 ./gradlew build，绕过环境变量歧义 - Mac 用户注意：/usr/bin/java 是 stub，实际由
/usr/libexec/java_home管理，建议用export JAVA_HOME=$(/usr/libexec/java_home -v 17)动态获取
最麻烦的情况是 IDE 和终端 JAVA_HOME 不一致——IntelliJ 默认用自己捆绑的 JDK，而终端用系统配置。这时候别只盯着环境变量，先看 IDE 的 Project SDK 和 Build Process JVM 设置是否对齐。
