📋 文章摘要

本文详细介绍在腾讯云轻量应用服务器（Ubuntu 20.04 LTS）上手动安装Oracle JDK 17的完整过程。包括安装包上传、解压、环境变量配置、验证安装等关键步骤，以及常见问题的解决方案。

关键词：JDK 17、Ubuntu、云服务器、Java环境配置、环境变量

---

🖥️ 环境说明

• 服务器：腾讯云轻量应用服务器
• 操作系统：Ubuntu 20.04 LTS
• JDK版本：Oracle JDK 17.0.16
• 安装方式：手动安装（tar.gz包）

---

📚 目录

1. 准备工作
2. 上传JDK安装包
3. 解压JDK安装包
4. 配置环境变量
5. 验证安装
6. 常见问题排查
7. 总结

---

1. 准备工作

1.1 下载JDK 17安装包

从Oracle官网下载JDK 17安装包：

• 下载地址：https://www.oracle.com/java/technologies/downloads/#java17
• 选择：Linux x64 Compressed Archive（.tar.gz格式）
• 文件名示例：jdk-17.0.16_linux-x64_bin.tar.gz

1.2 创建安装目录

# 创建JDK安装目录
sudo mkdir -p /opt/java

# 修改目录权限（允许当前用户写入）
sudo chown -R ubuntu:ubuntu /opt/java
sudo chmod -R 755 /opt/java

说明：

• /opt/java：JDK的标准安装位置
• 修改权限后，可以通过文件管理器上传文件

---

2. 上传JDK安装包

方式一：使用文件管理器上传（推荐）

1. 登录云服务器控制台
2. 进入文件管理器
3. 导航到 /opt/java 目录
4. 上传JDK安装包（.tar.gz文件）

注意：如果提示"无写权限"，执行以下命令修复：

sudo chown -R ubuntu:ubuntu /opt/java
sudo chmod -R 755 /opt/java

方式二：使用SCP命令上传

在本地电脑执行：

scp /path/to/jdk-17.0.16_linux-x64_bin.tar.gz ubuntu@服务器IP:/opt/java/

方式三：使用wget直接下载

cd /opt/java
wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.tar.gz

---

3. 解压JDK安装包

3.1 进入安装目录

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

---

🔗 相关文章推荐

• Spring Boot应用部署完整教程
• MySQL 8.0安装与远程连接配置
• 云服务器环境配置最佳实践

---

💬 问题反馈

如果在安装过程中遇到问题，欢迎在评论区留言，我会及时回复！

---

如果这篇文章对你有帮助，请点赞👍、收藏⭐、转发📤，让更多人受益！