Ubuntu 20.04 云服务器安装 JDK 17 完整教程

cd /opt/java
ls -la

预期输出：应该看到 JDK 安装包文件

3.2 解压安装包

# 解压 JDK 安装包
tar -xzf jdk-17.0.16_linux-x64_bin.tar.gz
# 查看解压后的目录
ls -la

预期结果：会看到类似 jdk-17.0.16 的目录

重要：记录解压后的实际目录名，后续配置环境变量需要使用。

3.3 验证解压结果

# 查看 JDK 目录结构
ls -la jdk-17.0.16/
# 应该看到以下目录：bin/, conf/, include/, jmods/, legal/, lib/, release

4. 配置环境变量

4.1 编辑系统配置文件

# 编辑系统级配置文件（所有用户生效）
sudo vi /etc/profile

4.2 添加 JDK 环境变量

在文件末尾添加以下内容：

# JDK 17 环境变量配置
export JAVA_HOME=/opt/java/jdk-17.0.16
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

重要说明：

• 将 /opt/java/jdk-17.0.16 替换为你实际的 JDK 目录名
• 如果解压后是其他名称，相应修改路径

4.3 保存并退出

• 按 Esc 退出编辑模式
• 输入 :wq 保存并退出
• 按回车确认

4.4 使环境变量生效

# 重新加载配置文件
source /etc/profile
# 或者重新登录 SSH 会话
exit
# 然后重新登录

5. 验证安装

5.1 检查 Java 版本

java -version

预期输出：

java version "17.0.16" 2025-07-15 LTS
Java(TM) SE Runtime Environment (build 17.0.16+12-LTS-247)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.16+12-LTS-247, mixed mode, sharing)

5.2 检查 Java 编译器版本

javac -version

预期输出：

javac 17.0.16

5.3 检查 JAVA_HOME 环境变量

echo $JAVA_HOME

预期输出：

/opt/java/jdk-17.0.16

5.4 检查 Java 路径

which java

预期输出：

/opt/java/jdk-17.0.16/bin/java

5.5 编译测试（可选）

# 创建测试文件
cat > Test.java <<'EOF'
public class Test {
    public static void main(String[] args) {
        System.out.println("JDK 17 安装成功！");
    }
}
EOF
# 编译
javac Test.java
# 运行
java Test

预期输出：

JDK 17 安装成功！

6. 常见问题排查

问题 1：java: command not found

错误信息：

bash: java: command not found

可能原因：

1. 环境变量未正确配置
2. 配置文件未重新加载

解决方案：

# 1. 检查 JAVA_HOME 是否设置
echo $JAVA_HOME
# 2. 如果为空，检查配置文件
sudo cat /etc/profile | grep JAVA_HOME
# 3. 重新加载配置
source /etc/profile
# 4. 或者重新登录 SSH

问题 2：JAVA_HOME 路径错误

错误信息：

Error: JAVA_HOME is not set correctly

解决方案：

# 1. 查看实际的 JDK 目录
ls -la /opt/java/
# 2. 确认 JDK 目录名
# 3. 修改 /etc/profile 中的 JAVA_HOME 路径
sudo vi /etc/profile
# 4. 修改后重新加载
source /etc/profile

问题 3：权限不足

错误信息：

Permission denied

解决方案：

# 修改目录权限
sudo chown -R ubuntu:ubuntu /opt/java
sudo chmod -R 755 /opt/java

问题 4：版本显示不正确

可能原因：系统有多个 Java 版本

解决方案：

# 1. 检查所有 Java 版本
update-alternatives --list java
# 2. 如果安装了多个版本，设置默认版本
sudo update-alternatives --config java
# 3. 或者直接使用完整路径
/opt/java/jdk-17.0.16/bin/java -version

7. 环境变量配置说明

JAVA_HOME

JDK 的安装根目录，其他程序通过这个变量查找 Java。

JRE_HOME

Java 运行环境的目录（JDK 包含 JRE）。

CLASSPATH

Java 类路径，告诉 JVM 在哪里查找类文件。

PATH

将 Java 的 bin 目录添加到系统路径，使 java和javac 命令可以在任何地方使用。

8. 完整安装命令序列

如果安装包已上传，可以一次性执行：

# 1. 进入安装目录
cd /opt/java
# 2. 查看文件
ls -la
# 3. 解压（根据实际文件名调整）
tar -xzf jdk-17.0.16_linux-x64_bin.tar.gz
# 4. 查看解压后的目录名
ls -la
# 5. 编辑配置文件
sudo vi /etc/profile
# 6. 在文件末尾添加（根据实际目录名调整）：
# export JAVA_HOME=/opt/java/jdk-17.0.16
# export JRE_HOME=$JAVA_HOME/jre
# export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib
# export PATH=$JAVA_HOME/bin:$PATH
# 7. 使配置生效
source /etc/profile
# 8. 验证安装
java -version
javac -version
echo $JAVA_HOME

9. 替代方案：使用 apt 安装 OpenJDK 17

如果不想手动安装，可以使用 apt 直接安装：

# 更新软件包列表
sudo apt update
# 安装 OpenJDK 17
sudo apt install -y openjdk-17-jdk
# 验证安装
java -version
javac -version

优点：

• 安装简单，一条命令搞定
• 自动配置环境变量
• 自动更新

缺点：

• 版本可能不是最新的
• 无法自定义安装位置

10. 总结

本文详细介绍了在 Ubuntu 20.04 云服务器上安装 JDK 17 的完整流程：

1. ✅ 创建安装目录并设置权限
2. ✅ 上传 JDK 安装包
3. ✅ 解压安装包
4. ✅ 配置环境变量（JAVA_HOME、PATH 等）
5. ✅ 验证安装

关键配置点：

• JAVA_HOME=/opt/java/jdk-17.0.16：JDK 安装路径
• PATH=$JAVA_HOME/bin:$PATH：将 Java 命令添加到系统路径
• source /etc/profile：使配置生效

验证成功标志：

• java -version 显示版本为 17
• javac -version 显示版本为 17
• echo $JAVA_HOME 显示正确的路径

参考命令速查

# 查看 Java 版本
java -version
# 查看 Java 编译器版本
javac -version
# 查看 JAVA_HOME
echo $JAVA_HOME
# 查看 Java 路径
which java
# 重新加载环境变量
source /etc/profile