直接用 update-alternatives 可干净切换 JDK 17 和 21,但需分别注册 java 与 javac、验证路径及可执行性,并手动同步 JAVA_HOME 以确保构建工具一致。

直接用 update-alternatives 就能干净切换 JDK 17 和 JDK 21,不需要改 JAVA_HOME、不用 reload shell、不依赖 SDKMAN 或 jenv——前提是路径对、权限够、注册完整。
确认 JDK 安装路径是否可用
别急着注册,先验证解压后的 JDK 目录里真有可执行文件。常见错误是解压不全、权限被锁死、或路径写错(比如漏了 bin/java)。
- 检查
/usr/lib/jvm/jdk-17.0.14+8/bin/java是否存在且可执行:ls -l /usr/lib/jvm/jdk-17.0.14+8/bin/java - 测试能否直接运行:
/usr/lib/jvm/jdk-17.0.14+8/bin/java -version—— 必须输出版本号,否则update-alternatives注册后也调不动 - 常见坑:CentOS/RHEL 默认把 OpenJDK 装在
/usr/lib/jvm/java-17-openjdk-*,而 Oracle/Adoptium 包解压后路径带+或_,别手抖删掉
用 update-alternatives 注册 java 和 javac
update-alternatives 不是“选一个就完事”,它管的是命令软链,java 和 javac 必须分开注册,否则编译时可能用 JDK 21 的 java 却调 JDK 17 的 javac,报 Unsupported class file major version。
- 注册 JDK 17:
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17.0.14+8/bin/java 170 - 注册 JDK 21:
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-21.0.4+7/bin/java 210 - 同样注册
javac(路径和优先级数字要一一对应):sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-17.0.14+8/bin/javac 170和sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-21.0.4+7/bin/javac 210 - 优先级数字(如 170/210)只影响默认选中项,不决定能否切换;只要注册成功,
--config就能手动选
切换时为什么 java -version 对了但 mvn 编译报错
因为 mvn 默认读 JAVA_HOME,而 update-alternatives 只改 /usr/bin/java 软链,不碰环境变量。两者不同步就会出问题。
- 临时修复:切换后手动设
JAVA_HOME:export JAVA_HOME=/usr/lib/jvm/jdk-21.0.4+7 - 长期方案:在
/etc/profile.d/java.sh里加函数,例如:jdk21() { export JAVA_HOME=/usr/lib/jvm/jdk-21.0.4+7; export PATH=$JAVA_HOME/bin:$PATH; },然后执行jdk21 - 验证是否同步:
java -version和echo $JAVA_HOME输出的主版本号必须一致;否则 Maven、Gradle、IDEA 后台进程大概率用错 JDK
alternatives --config java 没反应或报错
不是命令坏了,通常是注册阶段出错没暴露出来。最常踩的三个点:
-
Permission denied:没加sudo,/usr/bin下的链接只能 root 写 - 空白列表或 “no alternatives for java”:注册时路径写成
/usr/lib/jvm/jdk-21(少了一级子目录),实际应为/usr/lib/jvm/jdk-21.0.4+7/bin/java - 选完没生效:没运行
source /etc/profile或新开终端——update-alternatives改的是系统级软链,但 shell 进程缓存了旧的$PATH,重启终端最稳
真正麻烦的从来不是注册几个版本,而是确保 java 命令、JAVA_HOME、构建工具三者指向同一个 JDK 目录。少验证任意一环,CI 构建失败、本地调试不一致、甚至 jar 包运行时报 java.lang.UnsupportedClassVersionError 都会找上门。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











