Linux切换JDK版本实现方式
作者:0xDevNull
假设你的服务器上已经手动安装了以下三个版本的 JDK(路径仅为示例,请替换为你实际的路径):
- JDK 8:
/usr/local/java/jdk-1.8.0_391 - JDK 11:
/usr/local/java/jdk-11.0.21 - JDK 17:
/usr/local/java/jdk-17.0.9
第一步:将新安装的 JDK 注册到 alternatives 系统
如果你是通过 yum/dnf 安装的,系统通常会自动注册。但如果你是手动解压安装的(如上一轮对话所述),你需要手动告诉系统:“嘿,这里有个新的 Java 版本,请把它加入候选列表”。
我们需要分别注册 java (运行环境) 和 javac (编译器)。
1. 注册 JDK 8
#/usr/local/java/jdk-1.8.0_391/ 这是你的服务器的jdk安装路径 # 注册 java 命令 (优先级设为 108,数字越大优先级越高,但交互模式下不重要) sudo alternatives --install /usr/bin/java java /usr/local/java/jdk-1.8.0_391/bin/java 108 # 注册 javac 命令 sudo alternatives --install /usr/bin/javac javac /usr/local/java/jdk-1.8.0_391/bin/javac 108
2. 注册 JDK 11
sudo alternatives --install /usr/bin/java java /usr/local/java/jdk-11.0.21/bin/java 111 sudo alternatives --install /usr/bin/javac javac /usr/local/java/jdk-11.0.21/bin/javac 111
3. 注册 JDK 17
sudo alternatives --install /usr/bin/java java /usr/local/java/jdk-17.0.9/bin/java 117 sudo alternatives --install /usr/bin/javac javac /usr/local/java/jdk-17.0.9/bin/javac 117
参数解释
/usr/bin/java: 系统通用的命令路径(用户敲java时实际调用的位置)。java: 这个替代组的名称。/usr/local/.../bin/java: 你实际安装的 JDK 文件路径。108/111/117: 优先级。如果不进行自动切换,这个数字仅用于排序;在手动交互模式下,选哪个完全由你决定。
工作流程图解释
当你执行完 --install 后,系统内部发生了以下变化:
- 创建主链接:
/usr/bin/java->/etc/alternatives/java - 创建实际指向:
/etc/alternatives/java->/usr/local/java/jdk-17/bin/java(你注册的路径) - 记录配置:在
/var/lib/alternatives/java文件中记录下所有已注册的版本列表和优先级。
以后当你运行 sudo alternatives --config java 时,系统就是读取这个列表让你选。一旦你选了新的版本,它只需要修改 /etc/alternatives/java 这个中间层的指向,瞬间完成切换,无需重启。
常见错误排查
错误 1:link path already exists
- 现象:提示
/usr/bin/java已经存在。 - 原因:该命令只能用于新增版本。如果
/usr/bin/java已经被其他版本占用(或者已经被注册过),你不能重复执行--install来覆盖它。
解决:
- 如果是想更新已有版本的路径:先用
--remove删除旧路径,再--install新路径。 - 如果是想添加第二个版本:直接运行命令即可,
alternatives允许同一个组名下有多个不同路径的注册,它会自动管理链接。注:如果提示存在,通常是因为你之前已经成功注册过该路径,无需再次注册。
错误 2:permission denied
- 原因:没有加
sudo。修改/usr/bin和/etc/alternatives需要 root 权限。 - 解决:在命令前加
sudo。
错误 3:优先级设置混乱
- 现象:自动模式下切换到了不想要的版本。
- 解决:手动模式 (
--config) 不受优先级影响。如果在自动模式下,确保最高优先级的数字给的是你希望默认使用的那个版本。或者直接使用sudo alternatives --auto java让系统自动选优先级最高的,或用--config强制手动指定。
第二步:配置动态 JAVA_HOME(推荐)
为了让 JAVA_HOME 随 alternatives 切换自动更新,在/etc/profile.d/java.sh文件中添加:
# 编辑Java.sh vim /etc/profile.d/java.sh
# 检测 java 命令是否存在
if [ -x "/usr/bin/java" ]; then
# 1. 动态获取 JAVA_HOME
# 核心逻辑:解析 /usr/bin/java 的真实路径并去掉 /bin/java 后缀
export JAVA_HOME=$(readlink -f /usr/bin/java | sed 's:/bin/java::')
# 将当前 JAVA_HOME 的 bin 目录加入 PATH (通常 /usr/bin 已经在 PATH 里,但这步是为了确保优先级或完整性)
export PATH=$JAVA_HOME/bin:$PATH
# 2. 动态配置 JRE_HOME (兼容 JDK 8 和 JDK 11+)
if [ -d "$JAVA_HOME/jre" ]; then
# JDK 8: 存在独立的 jre 目录
export JRE_HOME=$JAVA_HOME/jre
else
# JDK 9+: 没有独立 jre 目录,JRE_HOME 通常指向 JAVA_HOME 本身,或者留空让应用自动识别
# 许多现代应用如果检测到 JRE_HOME 不存在,会自动 fallback 到 JAVA_HOME
export JRE_HOME=$JAVA_HOME
fi
# 3. 动态配置 CLASSPATH
# 注意:现代 JDK (9+) 其实不需要手动设置 CLASSPATH 来包含 rt.jar,
# 但为了兼容旧脚本,我们保留逻辑,只在存在 lib 目录时添加。
CP_PATH=".:"
# 添加 $JAVA_HOME/lib (主要针对 JDK 8 的 tools.jar 等,JDK 9+ 下此目录也存在但内容不同)
if [ -d "$JAVA_HOME/lib" ]; then
CP_PATH="${CP_PATH}$JAVA_HOME/lib:"
fi
# 添加 $JRE_HOME/lib (主要针对 JDK 8 的 rt.jar)
if [ -d "$JRE_HOME/lib" ]; then
# 防止重复添加 (当 JRE_HOME == JAVA_HOME 时)
if [ "$JRE_HOME" != "$JAVA_HOME" ]; then
CP_PATH="${CP_PATH}$JRE_HOME/lib:"
fi
fi
# 去掉末尾多余的冒号并导出
export CLASSPATH=${CP_PATH%:}
fi然后保存后退出,执行下面生效配置:
source /etc/profile.d/java.sh
验证是否生效
# 检查当前 Java 版本 java -version javac -version # 检查 JAVA_HOME echo $JAVA_HOME # 查看 alternatives 当前配置 alternatives --display java
第三步:交互式切换版本(核心步骤)
现在所有版本都注册好了,你可以使用 --config 参数来选择一个默认版本。
1. 切换java(运行环境)在终端输入
sudo alternatives --config java
你会看到类似这样的输出:
There are 3 programs which provide 'java'. Selection Command ----------------------------------------------- + 1 /usr/local/java/jdk-1.8.0_391/bin/java * 2 /usr/local/java/jdk-11.0.21/bin/java 3 /usr/local/java/jdk-17.0.9/bin/java Enter to keep the current selection[+], or type selection number:
符号说明:
+: 表示当前正在使用的版本。*: 表示上次手动选择的版本(如果没改过,通常和+一样)。
操作方法:
- 如果想切换到 JDK 17,直接输入数字
3然后按 回车。 - 如果想保持现状,直接按 回车。
- 如果想切换到 JDK 17,直接输入数字
2. 切换javac(编译器)注意
java和javac是分开管理的!切换完运行环境后,务必也切换编译器,否则可能出现“用 JDK 17 运行,却用 JDK 8 编译”的奇怪错误。
在终端输入:
sudo alternatives --config javac
操作同上:看到列表后,输入对应 JDK 版本的数字编号并回车。
第四步:验证切换结果
切换完成后,不需要重启服务器,立即生效。请运行以下命令确认:
# 1. 检查运行版本 java -version # 2. 检查编译版本 javac -version # 检查 JAVA_HOME echo $JAVA_HOME # 查看 alternatives 当前配置 alternatives --display java
常见问题与技巧
Q1: 我想删除某个注册的版本怎么办?如果你卸载了 JDK 11,需要把它从 alternatives 列表中移除,否则会报错找不到文件。
# 语法:sudo alternatives --remove <组名> <完整路径> sudo alternatives --remove java /usr/local/java/jdk-11.0.21/bin/java sudo alternatives --remove javac /usr/local/java/jdk-11.0.21/bin/javac
Q2: 如何查看当前有哪些版本被注册了(不切换)?
alternatives --display java alternatives --display javac
这会列出所有已注册的 path 和当前的状态,适合脚本检查。
Q3: 为什么我输入命令提示command not found?确保你使用的是sudo,因为修改/usr/bin下的链接需要 root 权限。普通用户只能查看 (alternatives --display) 不能配置。
总结
在 CentOS/RHEL 上切换 JDK 的核心逻辑就是:
1. 手动安装 -> 2. alternatives --install 注册 -> 3. alternatives --config 选择。
一旦注册过,以后随时可以通过第 3 步瞬间切换,无需修改任何配置文件或重启服务。
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。
