java_home必须使用绝对路径,因为java工具链(如maven、gradle、ide、tomcat等)直接拼接路径且不解析相对路径、波浪号或shell变量,工作目录变更后相对路径立即失效。

Java环境变量里用./jdk这种相对路径会直接失效
Windows 和 Linux/macOS 下,JAVA_HOME 和 PATH 中的路径必须是绝对路径,系统启动任何进程时都不会以你“当前终端所在目录”为基准去解析相对路径。哪怕你在 /opt/java 目录下执行 export JAVA_HOME=./jdk,新开一个终端或运行 IDE、Maven、Gradle 时,这个 ./jdk 就彻底找不到——因为工作目录变了。
-
JAVA_HOME被多数工具(如 Maven 的maven-compiler-plugin)直接读取并拼接/bin/java,不经过 shell 展开,也不支持波浪号~或点号. - IDE(如 IntelliJ)启动时读取的是系统级或用户级环境变量,不是你某次
source的 shell 会话变量 - 某些脚本(如 Tomcat 的
catalina.sh)会尝试用readlink -f处理JAVA_HOME,但前提是它本身已为绝对路径;相对路径传进去只会导致readlink返回空或错误
为什么JAVA_HOME非得用绝对路径:工具链的调用逻辑决定的
从 javac 到 java 再到 jdeps,JDK 自带工具默认通过 JAVA_HOME 推导自身位置。比如 java 启动时会尝试读取 $JAVA_HOME/jre/lib/tzdb.dat(旧版)或 $JAVA_HOME/conf/management.properties(JDK 9+),这些路径硬编码在二进制中,不做字符串拼接外的任何解析。
- Windows 上注册表或
java.exe的 manifest 可能绕过JAVA_HOME,但 Maven、Gradle、Spring Boot CLI 等 Java 生态工具一律依赖该变量 - Linux/macOS 下,
which java返回的是PATH中首个可执行文件,但它的上级目录不等于JAVA_HOME——例如你把openjdk-17-jdk装在/usr/lib/jvm/java-17-openjdk-amd64,而PATH里加的是/usr/lib/jvm/java-17-openjdk-amd64/bin,此时JAVA_HOME必须显式设为前者 - 容器或 CI 环境(如 GitHub Actions)中,
JAVA_HOME常由 setup-java action 自动写死为绝对路径,手动覆盖成相对路径会导致后续步骤全部失败
JAVA_HOME 绝对路径的典型写法与常见错误
不同系统下路径格式差异小,但斜杠方向、空格、符号转义容易翻车。关键不是“怎么写好看”,而是“怎么写能让所有工具稳定识别”。
- Linux/macOS:推荐
/home/username/.sdkman/candidates/java/current(sdkman 管理时)或/opt/java/jdk-17.0.2;避免含空格路径,如/Program Files/Java/jdk-17在 shell 中需引号,但多数 Java 工具不支持引号包裹的JAVA_HOME - Windows:必须用正斜杠或双反斜杠,如
C:/Program Files/Java/jdk-17.0.2或C:\Program Files\Java\jdk-17.0.2;单反斜杠C:Program FilesJavajdk-17.0.2在部分 shell(如 Git Bash)中会被误解析为转义字符 - 不要用
~:虽然 shell 能展开,但JAVA_HOME=~/.sdkman/candidates/java/current在子进程中不会自动替换,等价于字面量~/...,结果就是路径不存在 - 验证是否生效:运行
echo $JAVA_HOME(Linux/macOS)或echo %JAVA_HOME%(Windows),再执行$JAVA_HOME/bin/java -version—— 这步比只看java -version更可靠
想“动态切换 JDK”?别靠相对路径,用软链接或工具链管理
有人试图用 ln -sf ./jdk-11 jdk + JAVA_HOME=$PWD/jdk 实现切换,本质仍是把相对路径塞进环境变量,不可靠。真正可持续的做法是解耦“安装位置”和“引用位置”。
立即学习“Java免费学习笔记(深入)”;
- Linux/macOS 推荐
update-alternatives或sdkman:sdk use java 17.0.2-tem会自动更新JAVA_HOME为绝对路径,且对所有新 shell 生效 - Windows 可用
setx JAVA_HOME "C: oolsjdk-17"配合批处理脚本切换,注意setx修改的是注册表级变量,需重启 cmd 或用refreshenv(chocolatey 提供) - CI/CD 中优先用平台原生方式:GitHub Actions 用
actions/setup-java,GitLab CI 用image: openjdk:17-jdk-slim,避免手写路径 - IDE 内部 JDK 配置(如 IntelliJ 的 Project SDK)和
JAVA_HOME是两套体系,改环境变量不影响已配置的项目 SDK,这点常被忽略










