在阿里云 ECS 上部署 Java 项目,安装 JDK 只是开头。系统发行版、服务器架构和项目要求的 Java 版本都可能不同;环境变量即使在终端里配置好了,后台服务也未必能读取。按“确认系统、安装 JDK、配置环境、检查服务”的顺序处理,能少走不少弯路。
一、确认 Linux 版本和服务器架构
阿里云服务器可能运行 Alibaba Cloud Linux、CentOS、Rocky Linux 或 Ubuntu。先通过 SSH 登录服务器,查看发行版和 CPU 架构:
cat /etc/os-release
uname -m
如果架构显示 x86_64,通常应选 x64 版本;显示 aarch64,则要选 ARM64 版本。还要核对项目需要的 Java 版本:旧项目可能依赖 JDK 8,较新的 Spring Boot 项目常使用 JDK 17 或 21。以项目构建文件或部署文档为准,别只因为版本更新就直接安装最新版。
二、使用系统包管理器安装
服务器能访问软件源时,包管理器通常是更省事的选择,后续升级和卸载也比较方便。安装前可以先更新软件包索引或缓存。
Alibaba Cloud Linux、CentOS 等系统
较新的系统通常使用 dnf,部分系统仍使用 yum。下面以安装 OpenJDK 17 为例:
sudo dnf install -y java-17-openjdk-devel
如果系统没有 dnf,可以尝试:
sudo yum install -y java-17-openjdk-devel
构建 Java 项目时,建议安装带有 devel 的开发包。只安装运行环境可能没有 javac 编译器,构建时就会遇到找不到编译命令的问题。
Ubuntu 系统
Ubuntu 使用 apt 安装。先更新软件包列表,再安装所需版本:
sudo apt update
sudo apt install -y openjdk-17-jdk
项目需要 JDK 8 时,可将示例中的版本换成软件源提供的对应版本。如果提示找不到软件包,先检查 Ubuntu 版本和软件源配置,不要为了图快从来源不明的网站下载安装包。
三、手动安装指定版本
如果项目要求特定小版本,或者服务器无法连接系统软件源,可以从可信的 JDK 发行方获取 Linux 安装包。下载前核对 JDK 版本、文件格式和系统架构,避免把 Windows 安装包或 ARM64、x64 不匹配的文件传到服务器上。
下面以已上传到服务器的 tar.gz 压缩包为例。先创建目录,再解压:
sudo mkdir -p /opt/java
sudo tar -xzf jdk-17_linux-x64_bin.tar.gz -C /opt/java
解压后目录名可能随版本变化,可运行 ls /opt/java 查看。配置环境变量时要使用实际目录,不能直接照搬示例路径。手动安装便于固定版本,但之后的升级和旧版本清理也需要管理员自行处理。
四、设置 JAVA_HOME 和 PATH
安装后,java 命令有时已经可以使用。为让构建工具和应用明确找到 JDK,建议设置 JAVA_HOME。使用系统包安装时,可先查看当前 java 命令指向的位置:
readlink -f $(which java)
再根据实际安装目录配置环境变量。手动安装的写法如下,路径要替换成服务器上的真实目录:
export JAVA_HOME=/opt/java/jdk-17
export PATH=$JAVA_HOME/bin:$PATH
这两条命令只在当前终端会话中生效。若希望重新登录后仍然有效,可将配置写入当前用户的 ~/.bashrc,再执行:
source ~/.bashrc
如果 Java 服务由专门的系统用户启动,或通过 systemd 管理,还要检查服务运行时能否读取到正确的 JAVA_HOME。交互式终端里的环境变量不会自动保证后台服务也能使用;配置写入用户文件还是系统配置,应根据服务的启动方式和影响范围决定。
五、检查安装结果
配置完成后,分别检查 Java 运行环境、编译器和 JAVA_HOME:
java -version
javac -version
echo $JAVA_HOME
java -version 应显示项目需要的主版本号,javac -version 有正常输出,则说明开发工具也已安装。如果服务器装有多个 Java 版本,可用 which java 和 readlink -f $(which java) 确认当前实际调用的程序。部分系统提供 alternatives 或 update-alternatives,可用于切换默认版本;切换后记得再核对 JAVA_HOME,确保它与当前 JDK 一致。
六、案例:为 Spring Boot 服务配置 JDK 17
假设小李要在阿里云 ECS 上部署一个要求 Java 17 的 Spring Boot 项目,服务器运行 Alibaba Cloud Linux,架构为 x86_64。他先用 cat /etc/os-release 和 uname -m 确认系统信息,再通过 dnf 安装 java-17-openjdk-devel。安装后,java -version 和 javac -version 都显示 17,命令行检查没有问题。
但启动服务时,脚本仍提示找不到 Java。原因是服务通过 systemd 启动,无法读取小李交互式终端中的环境变量。他检查服务配置,在服务环境中指定正确的 JAVA_HOME,重新加载 systemd 配置后再启动。遇到类似情况,不要只反复安装 JDK;先确认服务由哪个用户启动,以及它实际读取了哪些环境变量。
七、常见问题与安全提醒
- 提示 java: command not found:检查 JDK 是否安装,确认 PATH 包含 $JAVA_HOME/bin;修改配置后,重新加载对应的配置文件。
- java 和 javac 版本不一致:检查是否安装了多个版本,并确认默认 Java 与 JAVA_HOME 指向同一套 JDK。
- 安装包无法使用:核对文件格式、系统架构和权限,尤其不要把 ARM64 安装包用于 x86_64 服务器。
- 应用启动失败:除 JDK 版本外,也要查看应用日志、启动用户权限和服务环境变量。
阿里云 Linux 安装 JDK 时,先核实系统和架构,再按项目要求选版本,最后分别检查终端和后台服务的运行环境。生产环境变更前做好备份或快照,并确认安装包来源,后续升级或回退会更稳妥。