在阿里云服务器上部署 Java 项目,JDK 版本要先和项目要求对上。选错版本,可能编译失败或启动时报错;环境变量没配好,则可能出现系统找不到 java 命令的情况。准备安装前,先核对服务器系统、项目使用的 Java 版本,以及应用打算通过什么方式启动。
下面以常见的 Linux 服务器为例,说明如何选择和安装阿里云服务器 JDK、检查配置,并排查部署中容易遇到的问题。
一、先确认服务器系统和项目要求
登录服务器后运行 cat /etc/os-release,确认系统名称和版本。Alibaba Cloud Linux、CentOS、Ubuntu、Debian 使用的软件包管理工具可能不同,安装命令不能直接混用。
再检查项目要求的 Java 版本。新项目可以考虑仍受维护的长期支持版本,例如 JDK 17 或 JDK 21;老项目可能依赖 JDK 8。查看项目的部署说明、Maven 的 pom.xml 或 Gradle 配置,通常能找到编译版本要求。开发电脑装了哪个版本,并不能说明服务器也必须使用同一版本。
JDK 包含运行 Java 程序所需的组件,也提供 javac 等编译工具。若只运行已经打包好的应用,具体需要哪种运行环境要看项目或供应商的要求;如果还要在服务器上编译代码,安装完整 JDK 更方便。
二、用系统软件源安装 JDK
使用系统软件源安装,后续更新和管理都比较直接。先确认软件包名称与系统版本匹配,再执行对应命令。
- Ubuntu 或 Debian:运行 sudo apt update 更新软件包索引,再执行 sudo apt install openjdk-17-jdk 安装 JDK 17。项目需要其他版本时,应先确认系统仓库是否提供对应软件包。
- Alibaba Cloud Linux 或 CentOS 系发行版:可尝试运行 sudo dnf install java-17-openjdk-devel。旧版系统可能使用 yum;安装前可以用 dnf search openjdk 或 yum search openjdk 查看可用包。
不同发行版的软件包名称和仓库内容可能不一样。如果提示找不到软件包,先核对系统版本、仓库配置和包名,不要直接套用其他系统的命令。生产环境尽量从可信的软件源安装,并记下 JDK 发行版和具体版本,方便之后排查或升级。
三、安装后检查 Java 和 javac
安装完成后运行 java -version 查看 Java 版本,再运行 javac -version 检查编译器。两条命令都能显示版本号,通常说明 JDK 已安装并能通过当前命令路径调用。
如果出现“command not found”,先确认软件包是否安装成功,再用 which java 查看命令位置。服务器上如果装有多个 Java 版本,还要检查当前默认版本和应用实际调用的版本是否一致。只在终端里看到正确版本,不代表服务启动时也会使用它。
四、手动安装并设置环境变量
系统仓库没有项目所需版本,或项目指定了某个 JDK 发行版时,可以从发行商官方渠道下载 Linux 安装包。下载前检查服务器架构,例如 x86_64 或 aarch64,并核对文件来源和校验信息。不要从不明网站获取安装包。
以压缩包为例,可将文件解压到约定目录,例如 /opt/jdk。然后设置 JAVA_HOME,并把 JDK 的 bin 目录加入 PATH。以下配置可写入当前用户的 ~/.bashrc,也可以根据系统和部署方式放进合适的全局配置文件:
export JAVA_HOME=/opt/jdk/jdk-17
export PATH=$JAVA_HOME/bin:$PATH
保存后执行 source ~/.bashrc,再用 echo $JAVA_HOME、java -version 和 javac -version 检查结果。示例中的目录只是路径写法,必须改成服务器上的实际解压目录。
还要留意服务使用的账号。把变量写进个人的 shell 配置,只能说明该用户的交互终端能够读取,systemd 服务未必会继承这些设置。多用户部署时,应按应用的运行账号配置环境变量,或在服务配置中指定 JDK 路径。
五、在阿里云 ECS 上启动 Spring Boot 项目
假设一台 Ubuntu ECS 需要运行 JDK 17,Spring Boot 项目已打包为 app.jar。先确认实例的系统和架构,安装 OpenJDK 17,并运行 java -version 验证。随后把 jar 包上传到应用目录,例如 /opt/myapp/。
可以先进入应用目录,以当前用户运行 java -jar app.jar,观察控制台输出和应用日志,确认项目能否正常启动。测试通过后,再配置 systemd 管理进程,让服务按需要随系统启动。不要长期依赖 SSH 窗口维持应用运行,也不建议用 root 启动业务程序;可以创建专用用户,并限制该用户对应用目录的访问权限。
如果应用监听 8080 端口,只有在确实需要从公网直接访问时,才开放相应的阿里云安全组规则。更常见的做法是让反向代理或负载均衡访问应用端口。安全组和服务器内部防火墙是两层控制,访问异常时需要分别检查。数据库密码等敏感信息也不要放进公开的启动脚本或代码仓库。
六、JDK 安装和 Java 部署常见问题
- 提示找不到 java:检查 JDK 是否安装,以及 PATH 是否包含 JDK 的 bin 目录。刚修改配置时,重新加载对应环境文件或重新登录。
- java 能运行,但 javac 不存在:检查是否装了仅含运行环境的软件包,或 JDK 的 bin 目录是否在 PATH 中。需要编译代码时,安装完整 JDK 并核对 JAVA_HOME。
- SSH 里能启动,systemd 服务却失败:服务可能没有读取用户的 shell 环境变量。在服务配置中明确指定 JAVA_HOME,或使用 Java 的绝对路径,并通过服务日志查看具体错误。
- 项目提示 Java 版本不兼容:重新核对项目要求和当前默认版本。若服务器上有多个版本,检查启动命令实际调用的 Java,不要只依据交互终端中的 java -version 判断。
- 服务已启动,但外网无法访问:确认应用监听的地址和端口,再检查安全组、系统防火墙及反向代理配置。排错完成后,关闭不再需要的端口。
部署前确认系统和项目版本要求,安装后再检查 JAVA_HOME、PATH 以及服务运行账号,能避开不少常见问题。测试环境用系统软件源通常更省事;生产环境则应固定 JDK 版本、选择可信来源,并记录服务配置和安全组规则,方便后续维护和故障排查。