在阿里云 ECS 上部署 Java 应用,装好 JDK 只是第一步。还要确认版本符合项目要求、系统调用的是预期的 Java,以及编译和运行链路都正常。下面以 Ubuntu 22.04 为例,使用系统软件源安装 OpenJDK,并用一个简单程序验证。不同 Ubuntu 版本的软件包可能有差异,操作前先核对系统信息。
一、确认系统版本和架构
通过 SSH 登录 ECS 后,查看 Ubuntu 版本与 CPU 架构:
lsb_release -a
uname -m
如果系统没有 lsb_release 命令,可以运行 cat /etc/os-release 查看发行版信息。常见的 x86 实例会显示 x86_64,ARM 实例通常显示 aarch64。确认这两项,可以减少选错软件包或照搬其他系统命令的情况。
刷新软件包索引:
sudo apt update
这条命令只更新软件包列表,不会自动升级已安装的软件。线上服务器不要把“更新索引”和“全量升级”混为一谈;安装 JDK 时尽量控制变更范围,出现问题也更容易定位。
二、按项目要求选择并安装 JDK
先查项目要求,再决定安装哪个版本。新项目可能使用 Java 17 或 Java 21;较早的应用、构建脚本或第三方组件也可能依赖 Java 8、Java 11。检查项目文档、pom.xml、Gradle 配置和部署要求,不要单凭“版本越新越好”来选。
可以先搜索当前软件源提供的软件包:
apt search openjdk
如果项目需要 Java 17,安装命令是:
sudo apt install -y openjdk-17-jdk
需要 Java 21 时,可将包名改为 openjdk-21-jdk。如果搜索不到对应版本,先核对 Ubuntu 版本和软件源配置,不要为了省事运行来源不明的安装脚本或添加陌生仓库。生产环境通常优先使用发行版软件源中的维护版本,后续更新和依赖管理会更直接。
安装完成后,分别检查 Java 运行时和编译器:
java -version
javac -version
输出的版本应与项目要求一致。只运行已经编译好的程序时,有些场景只需要运行时;要在服务器上编译 Java 源码,则需要安装包含 javac 的 JDK。
三、检查并切换默认 Java 版本
同一台 ECS 上可能安装了多个 JDK。此时,java 命令调用哪个版本,可以通过 alternatives 查看和切换:
sudo update-alternatives --config java
如果终端列出了多个选项,按提示输入对应编号。编译器的默认版本需要单独检查:
sudo update-alternatives --config javac
切换后再运行 java -version 和 javac -version。这两个命令都要指向项目需要的版本;如果只安装了一个 JDK,通常不必额外调整。
四、哪些情况下需要设置 JAVA_HOME
不少程序直接调用系统里的 java 命令即可运行,但 Maven、Gradle、应用服务器或部署脚本可能会读取 JAVA_HOME。可以先查出 Java 可执行文件的实际位置:
readlink -f $(which java)
例如,命令结果为 /usr/lib/jvm/java-17-openjdk-amd64/bin/java,那么 JAVA_HOME 通常应设置为去掉末尾 /bin/java 后的目录:/usr/lib/jvm/java-17-openjdk-amd64。服务器上的实际路径可能不同,以命令输出为准。
如果只需要给当前用户配置,可以编辑 ~/.bashrc,在文件末尾添加:
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
保存后执行 source ~/.bashrc,再用 echo $JAVA_HOME 检查变量。要留意,systemd 启动的服务不一定会读取登录用户的 ~/.bashrc。如果命令行运行正常、服务启动时报找不到 Java,检查对应的 systemd 服务配置、运行用户和环境变量,不要只反复修改 shell 配置。
五、用小程序验证编译和运行
假设 ECS 使用 Ubuntu 22.04,项目要求 Java 17。安装后可以先创建一个测试目录:
mkdir -p ~/java-test && cd ~/java-test
新建 Hello.java,写入以下内容:
public class Hello { public static void main(String[] args) { System.out.println("Java is ready"); } }
执行 javac Hello.java 编译,再执行 java Hello。看到输出 Java is ready,说明 JDK、编译器和运行时基本可用。
这只能验证基础 Java 环境。项目如果使用 Maven 或 Gradle,还要运行实际构建命令,并核对构建进程使用的 Java 版本。终端里的 java -version 正确,不代表 Maven、Gradle 或 systemd 服务一定使用同一套配置。
六、常见问题与部署提醒
- 提示找不到软件包:先运行
sudo apt update,再核对包名和 Ubuntu 版本。当前软件源没有目标版本时,先检查软件源配置,不要直接执行不明安装脚本。 java和javac版本不一致:分别查看 alternatives 的默认项,并检查JAVA_HOME是否还指向旧版本目录。- SSH 中能运行,服务启动失败:检查 systemd 服务使用的用户、工作目录和环境变量。交互式 shell 的配置文件不一定会被服务加载。
- 服务器无法下载软件包:检查实例网络、DNS、出站访问策略和软件源连接。安装 JDK 通常不需要额外开放入站端口。
- 准备部署到生产环境:记录实际使用的 JDK 版本,升级前在测试环境验证应用兼容性,并准备回滚方案。
在阿里云 Ubuntu 上安装 JDK 后,先确认系统和项目版本,再检查 java、javac,最后用测试程序或项目自身的构建命令验证。这样能区分是 JDK 安装、版本选择还是服务环境配置出了问题。需要配置 JAVA_HOME 时,也应以服务器实际路径和服务启动方式为准。