java_home必须指向含bin、lib、jre的jdk完整版本子目录（如jdk-21.0.5），不可指向父级空目录或软链接；path须仅含%java_home%\bin或$java_home/bin，避免硬编码路径冲突，并重启终端及ide验证。
JAVA_HOME 必须指向完整版本子目录，不能只到父级目录
常见错误是把 JAVA_HOME 设成解压父目录，比如 /usr/local/java 或 C:\Program Files\Java —— 这里往往只是个空文件夹或软链接，导致 javac 找不到工具类、Maven 报 Could not find tools.jar、IDEA 识别为 invalid JDK。
正确写法必须包含具体版本号的子目录：
- Linux/macOS：
export JAVA_HOME=/usr/local/java/jdk-21.0.5 - Windows：
JAVA_HOME = D:\environment\JDK\jdk-21.0.10 - Dockerfile 中也一样：
ENV JAVA_HOME=/opt/java/jdk-21.0.4
注意：Oracle 官方 tar.gz 包解压后自带版本号目录；而 Windows 的 .exe 安装器默认路径如 C:\Program Files\Java\jdk-21 已含版本号，可直接用 —— 但若手动改过路径，务必确认该路径下存在 bin、lib 等子目录。
PATH 只加 $JAVA_HOME/bin，别重复加绝对路径
很多人在 Path（Windows）或 PATH（Unix）里既写 %JAVA_HOME%\bin，又额外加一条 C:\Program Files\Java\jdk-21\bin。这会导致多版本冲突：当 JAVA_HOME 切换后，命令行仍调用旧路径的 java，造成 java -version 和 javac -version 不一致。
实操建议：
- 删掉所有硬编码的 JDK bin 路径，只保留一条：
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（Linux/macOS） - macOS 若用
brew install java21，/usr/libexec/java_home -v 21返回的是符号链接，export JAVA_HOME必须用它的实际解析路径（可用readlink -f验证） - 验证时运行
which java和ls -l $(which java)，确保它指向$JAVA_HOME/bin/java
不要依赖系统自动配置的 javapath，尤其在多 JDK 共存时
Windows 的 .exe 安装器会往 Path 里加 C:\Program Files\Common Files\Oracle\Java\javapath，这个目录里放的是快捷方式，实际指向某个 JDK —— 但它不随 JAVA_HOME 变动，也不被 Maven/Gradle 读取，纯属“命令行能跑但生态工具不认”的陷阱。
典型症状：
-
java -version显示 21，mvn -v却报 Java 17 - IntelliJ IDEA 提示 “No JDK specified”，即使
JAVA_HOME已设 - 切换 JDK 后需重启 CMD/PowerShell 才生效，而 IDE 完全不响应
解决办法：直接删掉 javapath 条目，只靠 JAVA_HOME + %JAVA_HOME%\bin 统一管理。
Docker 镜像中 ENV 要显式声明，且避免用 update-alternatives 或软链
在 Docker 中用 apt install openjdk-21-jdk 看似省事，但 /usr/lib/jvm/java-21-openjdk-amd64 下的 java 往往是软链接，且 JAVA_HOME 未设或指向错误位置。容器启动后 java -version 成功，但 Spring Boot 应用启动失败，报 Unable to find main class。
稳妥做法：
- 用官方 tar.gz 解压安装：
RUN wget https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.tar.gz && tar -C /opt/java -xzf jdk-21_linux-x64_bin.tar.gz - 显式设 ENV：
ENV JAVA_HOME=/opt/java/jdk-21.0.5和ENV PATH=$JAVA_HOME/bin:$PATH - 别用
update-alternatives --install，它在无状态容器里没意义，还可能污染PATH
最易被忽略的一点：Docker 构建缓存会让旧 JAVA_HOME 残留，每次改版本号后务必清缓存或加 --no-cache。
