Ubuntu 环境下 JDK 1.8 环境变量配置指南

Ubuntu 环境下 JDK 1.8 环境变量配置指南 | 极客日志

Ubuntu 环境下 JDK 1.8 环境变量配置指南

在 Linux 系统（如 Ubuntu 16.04/18.04/20.04/22.04）中正确配置 JDK 环境变量，是开发 Java 应用、运行 Maven/Gradle 项目或部署 Java 服务（如 Spring Boot、Jenkins、Zabbix Java Gateway 等）的前提。本文将以 jdk1.8.0_181 为例，详细说明如何通过 /etc/profile 或用户级配置文件永久设置 JAVA_HOME、PATH 等关键环境变量。

一、配置内容（以 JDK 安装在 `/usr/local/jdk1.8.0_181` 为例）

将以下内容添加到你的 shell 配置文件中（推荐使用 /etc/profile 以全局生效，或 ~/.bashrc 仅对当前用户生效）：

# JDK 环境变量配置
export JAVA_HOME=/usr/local/jdk1.8.0_181
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib:$CLASSPATH
export JAVA_PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin
export PATH=$PATH:${JAVA_PATH}

各变量说明：

变量名	作用说明
`JAVA_HOME`	JDK 安装根目录，是大多数 Java 工具（如 Maven、Tomcat、Jenkins）识别 JDK 位置的关键变量。
`JRE_HOME`	JRE（Java 运行时环境）目录，部分旧应用依赖此变量。
`CLASSPATH`	Java 类路径。开头的 `.` 表示当前目录，后续添加 JDK 和 JRE 的核心库。注意保留原有 `$CLASSPATH`。
`JAVA_PATH`	非标准变量，仅为方便组合 `bin` 路径（可选，也可直接写入 `PATH`）。
`PATH`	将 `java`、`javac`、`jps` 等命令加入系统命令搜索路径，使终端可直接调用。

✅ 最佳实践：CLASSPATH 通常可省略（现代 Java 应用多通过 -cp 或构建工具指定），但保留也无害。

二、配置步骤

方法 1：全局配置（推荐用于服务器）

# 编辑全局 profile 文件
sudo vim /etc/profile

将上述 JDK 配置追加到文件末尾，保存退出。

然后重新加载配置：

source /etc/profile

⚠️ 注意：/etc/profile 对所有用户生效，适用于运维部署场景（如 Jenkins 服务器、应用主机）。

方法 2：当前用户配置（适合开发机）

# 编辑当前用户的 bashrc
vim ~/.bashrc

同样追加配置内容，保存后执行：

source ~/.bashrc

💡 提示：若使用 zsh，则应修改 ~/.zshrc。

三、验证配置是否生效

执行以下命令检查：

echo $JAVA_HOME
# 输出应为：/usr/local/jdk1.8.0_181
java -version
# 应显示：java version "1.8.0_181"
javac -version
# 应显示：javac 1.8.0_181
which java
# 应指向：/usr/local/jdk1.8.0_181/bin/java

若以上命令均输出正确，说明配置成功。

四、常见问题与注意事项

1. JDK 路径是否正确？

确保 /usr/local/jdk1.8.0_181 目录确实存在，且包含 bin/java 文件。若从 Oracle 官网下载的是 .tar.gz 包，通常需手动解压到该目录：

sudo tar -zxvf jdk-8u181-linux-x64.tar.gz -C /usr/local/

2. 多版本 JDK 如何切换？

可使用 update-alternatives 管理多个 JDK：

sudo update-alternatives --install /usr/bin/java java /usr/local/jdk1.8.0_181/bin/java 1
sudo update-alternatives --install /usr/bin/javac javac /usr/local/jdk1.8.0_181/bin/javac 1
sudo update-alternatives --config java # 手动切换

3. Docker 或 systemd 服务中不生效？

Docker：需在 Dockerfile 中显式设置环境变量。
systemd 服务：需在 .service 文件的 [Service] 段使用 Environment= 显式声明，因为 systemd 不加载 /etc/profile。

五、总结

通过在 /etc/profile 或用户 shell 配置文件中正确设置 JAVA_HOME、PATH 等变量，可确保 Java 开发与运行环境在 Ubuntu 系统中稳定可用。该配置适用于 Jenkins 构建、Spring Boot 应用部署、Zabbix Java Gateway 启动等多种运维与开发场景。

📌 小技巧：在编写 Jenkins Pipeline、Shell 部署脚本或自动化工具时，建议显式指定 JAVA_HOME，避免因环境差异导致构建失败。

Ubuntu 环境下 JDK 1.8 环境变量配置指南