必须同时注册java和javac，否则会导致编译时版本不一致；注册后需同步更新JAVA_HOME，并验证java -version与javac -version输出一致。
update-alternatives 必须同时注册 java 和 javac
只注册 java 命令，不注册 javac，是导致“IDE里能编译、命令行 mvn compile 报 Unsupported class file major version”的最常见原因。系统调用 java 和 javac 是两个独立路径，update-alternatives 不会自动同步它们。
正确做法是为每个 JDK 版本分别执行两条注册命令：
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17.0.3/bin/java 170sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-17.0.3/bin/javac 170
优先级数字（如 170）只需保证同一 JDK 的 java 和 javac 一致即可；不同版本间数字大小仅影响默认选中项，不影响切换能力。
切换后必须手动同步 JAVA_HOME
update-alternatives 只改 /usr/bin/java 软链，不碰环境变量。而 Maven、Gradle、Tomcat、IntelliJ IDEA 后台构建进程都依赖 JAVA_HOME，不一致就会用错 JDK。
立即学习“Java免费学习笔记（深入）”；
验证是否同步：执行以下两条命令，输出的主版本号必须完全一致：
-
java -version（看第一行java version "17.0.3"） -
echo $JAVA_HOME（应指向/usr/lib/jvm/jdk-17.0.3这类路径）
推荐在 ~/.bashrc 或 /etc/profile.d/java.sh 中定义快捷函数，例如：
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
jdk17() {
export JAVA_HOME=/usr/lib/jvm/jdk-17.0.3
export PATH=$JAVA_HOME/bin:$PATH
}
然后直接运行 jdk17 即可完成命令与环境变量双同步。
路径和权限检查比写命令更重要
注册前不验证路径有效性，90% 的 “切换无效” 都卡在这一步。常见失败点：
-
/usr/lib/jvm/jdk-17.0.3/bin/java文件不存在（解压不全、路径写错，比如漏了bin/） - 文件不可执行：
ls -l /usr/lib/jvm/jdk-17.0.3/bin/java显示权限不含x，需chmod +x - 路径含特殊字符未转义（如
jdk-21.0.4+7中的+，在 shell 中要加引号或反斜杠） - CentOS/RHEL 上误删了 OpenJDK 自带的
java-17-openjdk-amd64目录名中的-amd64后缀，导致实际路径失效
最简验证方式：/usr/lib/jvm/jdk-17.0.3/bin/java -version 必须能直接输出版本号，再注册。
包管理器安装的 JDK 已预注册，别重复操作
用 apt install openjdk-17-jdk（Ubuntu）或 dnf install java-17-openjdk-devel（RHEL/CentOS）装的 JDK，系统已自动完成：
- 注册
java和javac到update-alternatives - 创建
/usr/bin/java → /usr/lib/jvm/java-17-openjdk-xxx/bin/java软链 - 无需手动改
PATH，/usr/bin已在默认路径中
此时只需执行 sudo update-alternatives --config java 和 sudo update-alternatives --config javac 并选同一编号，再配好 JAVA_HOME 即可。强行手动注册同路径会引发冲突，--remove-all java 才能清理干净。
真正麻烦的不是注册命令本身，而是注册后没人检查 javac -version 是否和 java -version 一致，以及没人记得 JAVA_HOME 必须跟着手动更新——这两点漏掉，一切切换都是假动作。
