Linux切换JDK版本实现方式_Linux

假设你的服务器上已经手动安装了以下三个版本的 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 然后按回车。
- 如果想保持现状，直接按回车。

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 步瞬间切换，无需修改任何配置文件或重启服务。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持代码网。

Linux切换JDK版本实现方式

2026年03月05日 • Linux •我要评论