Ubuntu下Java部署环境搭建：JDK安装、JAVA_HOME配置与常见坑-代码聚汇网

Ubuntu下Java部署环境搭建：JDK安装、JAVA_HOME配置与常见坑

眠子子子·2026-09-03·阅读 106 GEO检测（免费）

UbuntuJavaJDK

|难度：普通|阅读约 37 分钟

刚接触Linux的人总以为“在Ubuntu上装好Java”就是执行一条安装命令，等到真正部署项目的时候，发现java -version虽然能输出版本号，可javac找不到、JAVA_HOME是空的、进程一启动就内存异常，最后才明白环境搭建这件事远没有表面那么简单。我早期从Windows切到Ubuntu时踩过几乎全套的坑，后来在不同的云服务器、虚拟机、Docker环境里反复部署过几十次，才慢慢形成一套“一次搭对、长期不折腾”的方法。这篇文章就围绕“Ubuntu + Java部署环境”这件事，把系统准备、JDK选型、环境变量、生产部署、高频坑位一次说透。

文章默认使用Ubuntu 22.04 LTS和Java 17组合，如果你用的是20.04或24.04，思路完全一致，只是软件源里可用版本号略有差异。零基础用户可以按章节顺序操作，已经有一定经验的人可以直接跳到第4和第5章看部署实践和踩坑思路。

1. 敲安装命令之前，先把系统层面的三件事确认清楚

很多人一进系统就急着sudo apt install openjdk-17-jdk，装完才发现系统版本老、源没换、连Java包都装成自己不想要的版本。磨刀不误砍柴工，系统层面的准备反而最影响后续体验。

1.1 确认Ubuntu版本：生产部署优先选LTS

Java环境不是装在越新的Ubuntu上越好，而是越“稳”越好。Ubuntu有几个不同的发布节奏，长期支持版本叫LTS，通常每两年出一个，桌面版和服务器版都提供五年的标准支持，这个周期几乎覆盖了一个项目的生存期。对部署环境来说，必须优先选择LTS版本。

先执行下面命令看看当前系统版本：

bash复制lsb_release -a
# 或者
cat /etc/os-release

如果你正在选云服务器镜像或者准备装虚拟机系统，我建议选22.04 LTS或24.04 LTS。以Ubuntu 22.04为例，软件源里默认带有Java 11和Java 17，运行Spring Boot 3项目绰绰有余；24.04默认带Java 21，适合想直接上最新LTS特性的人。

有个新手常见的误区：看到“最新版Ubuntu 24.10”就去装，其实非LTS版本的软件源和官方技术支持只有九个月，等你把环境搭好、项目跑起来，系统可能就停止维护了，到时候被迫强制升级，非常被动。部署环境不是追求桌面尝鲜的地方，稳定和生命周期才是第一优先级。

1.2 桌面版还是服务器版：学Java开发不等于必须装图形界面

许多人被“Ubuntu”这个词误导，以为装系统就一定会有桌面窗口，于是新手在虚拟机里装Desktop版本，服务器上也跟着装Desktop版本。其实Ubuntu官方提供两种镜像：Desktop桌面版和Server服务器版，二者内核一致，区别只是服务器版默认没有图形桌面，安装包更小、内存占用更低。

如果你是在本地虚拟机里学了Java基础、连Linux操作都还不熟，我建议先装桌面版，有图形界面会让前期压力小很多；如果目标是把Java项目部署到云服务器或公司测试机器上，请直接使用Server版，因为生产环境根本不需要桌面占用的几百MB内存，也减少了图形组件带来的安全风险。

这里还要提一句权限习惯：安装过程中创建的用户通常已经在sudo组里，日常操作直接用它就好，不要一上来就sudo su切到root，更不要禁止普通用户登录。用root操作一时爽，等文件权限错乱、某个服务因为目录属主问题起不来时，排查过程会让你怀疑人生。

1.3 换apt源：装软件前先把手动挡换成自动挡

Ubuntu安装软件主要靠apt工具，apt会读取系统配置的软件源地址。默认官方源虽然在境外，在国内访问速度确实很慢，延迟高的时候执行apt update都像卡住一样。解决方法是把软件源替换成国内镜像源，比较常用的是阿里云镜像和清华TUNA镜像。

从22.04开始，部分版本的apt源配置文件路径发生了变化，已经不完全是传统/etc/apt/sources.list单文件结构，而是采用/etc/apt/sources.list.d/ubuntu.sources的deb822格式。建议先看一下自己机器上的文件结构：

bash复制ls -l /etc/apt/sources.list*
cat /etc/apt/sources.list.d/*.sources 2>/dev/null | head -20

如果看到的是/etc/apt/sources.list，可以这样替换为阿里云源：

bash复制sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.aliyun.com@g' /etc/apt/sources.list
sudo sed -i 's@security.ubuntu.com@mirrors.aliyun.com@g' /etc/apt/sources.list
sudo apt update

如果看到的是ubuntu.sources，也可以用sed把其中http://archive.ubuntu.com/ubuntu/整体替换为http://mirrors.aliyun.com/ubuntu/。替换后记得执行：

bash复制sudo apt update && sudo apt upgrade -y

apt upgrade会把系统已有的安全补丁和依赖更新到软件源中的最新版本，这一步很值得做，Java相关的依赖在更新后能减少很多奇怪的兼容性问题。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. JDK选型和三种安装方式：部署环境里的决定没有想象中纠结

Java的环境组件叫JDK，但JDK本身又分成好几种发行版，很多刚接触的人会在这个选择上卡住。我直接把我现在的决策逻辑跟大家说清楚。

2.1 OpenJDK和Oracle JDK到底差多少

早期Oracle JDK和OpenJDK确实存在行为差异，但从Java 11之后，特别是Java 17时代，两者在代码层面已经高度一致，日常开发和生产运行几乎感觉不到区别。比较大的不同在许可协议上：Oracle JDK从Java 17开始采用Oracle No-Fee Terms and Conditions协议，个人使用没问题，但一些企业使用场景需要仔细核对条款；OpenJDK则始终是GPL协议，部署上少一层顾虑。

所以我的默认建议是：没有特殊情况，直接用发行版软件仓库里的OpenJD