在阿里云 ECS 上装好 Java 后,还要确认 JDK 版本符合项目要求,再把程序启动起来。只在终端里执行安装命令并不够:版本选错,项目可能启动失败;端口或监听地址没配好,程序即使运行了,外部也访问不到。下面按常见的 Linux 服务器部署流程说明。
先确认系统版本和项目要求
登录服务器后,先查看操作系统信息:
cat /etc/os-release
Alibaba Cloud Linux、Rocky Linux 等系统通常使用 dnf 或 yum,Ubuntu、Debian 通常使用 apt。安装前也要查清项目需要哪个 Java 版本。新项目常使用 JDK 17,部分旧项目仍依赖 JDK 8;应以项目构建配置、框架和依赖的要求为准,别只因为版本更新就直接安装最新版。
服务器还需要能够访问软件源。若实例处于受限网络环境,先检查 DNS、路由和软件源配置。安装 JDK 通常不需要开放专用端口;只有应用要从外部访问时,才需要按实际情况配置安全组规则。
安装 JDK 并核对版本
Alibaba Cloud Linux、Rocky Linux 等系统
以 OpenJDK 17 为例,先更新软件包信息,再安装开发版 JDK:
sudo dnf makecache
sudo dnf install -y java-17-openjdk-devel
部分旧版系统使用 yum,可以将命令中的 dnf 换成 yum。仓库里找不到所需版本时,先检查系统版本和软件源,不要从不明网站下载“一键安装包”。生产环境应优先使用可信软件仓库,并记录实际安装的 JDK 版本。
Ubuntu、Debian 系统
在 Ubuntu 上安装 OpenJDK 17,可以执行:
sudo apt update
sudo apt install -y openjdk-17-jdk
项目需要 Java 8 时,按系统仓库提供的版本安装。安装完成后,运行以下命令检查 Java 和编译器:
java -version
javac -version
输出中的主版本号应符合项目要求。如果服务器上装了多个 JDK,可以用 sudo alternatives –config java 选择默认版本;部分发行版使用 sudo update-alternatives –config java。切换后再运行 java -version,确认当前生效的版本。
按需设置 JAVA_HOME
直接运行 java 命令通常不需要手动设置 JAVA_HOME,但 Maven、Gradle、启动脚本或某些应用会读取这个变量。先查出 Java 可执行文件的位置:
readlink -f $(which java)
例如,命令返回 /usr/lib/jvm/java-17-openjdk/bin/java,对应的 JAVA_HOME 通常是 /usr/lib/jvm/java-17-openjdk。服务器上的实际目录可能不同,应以查询结果为准。确认路径后,可在当前用户的 shell 配置文件中添加:
export JAVA_HOME=/实际的JDK目录
export PATH=$JAVA_HOME/bin:$PATH
保存后执行 source ~/.bashrc,再用 echo $JAVA_HOME 检查变量是否生效。若项目通过 systemd 启动,不要假设服务会读取交互式终端的配置;需要时应在服务配置中明确指定环境变量。
上传项目并启动
假设项目已打包成 app.jar,先将文件上传到服务器的应用目录。可以先在终端前台运行,确认程序能否正常启动:
java -jar app.jar
如果命令报错,终端通常会显示启动失败原因;如果程序启动后不退出,再按项目实际情况检查访问地址和端口。临时测试可以在终端运行,长期运行则建议用 systemd 管理服务,便于设置开机启动、查看状态和排查日志。
创建 /etc/systemd/system/myapp.service 时,应把用户名、工作目录和 JAR 路径替换成实际值。配置文件各项需分行填写,例如:
[Unit]
After=network.target
[Service]
User=www
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/java -jar /opt/myapp/app.jar
Restart=on-failure
[Install]
WantedBy=multi-user.target
确认 /usr/bin/java 是服务器上的实际 Java 路径,且服务用户有权限读取 JAR 文件和访问工作目录。保存后执行:
sudo systemctl daemon-reload
sudo systemctl enable –now myapp
sudo systemctl status myapp
需要查看最近的服务日志时,运行 sudo journalctl -u myapp -n 100 –no-pager。服务状态显示启动失败时,优先核对 Java 路径、JAR 文件位置、运行用户权限和端口占用。
Spring Boot 项目无法外网访问时怎么查
例如,团队把 Spring Boot 项目打包为 shop.jar,服务器使用 Alibaba Cloud Linux,项目要求 Java 17。管理员安装 java-17-openjdk-devel,确认 java -version 显示 17,再将程序放到 /opt/shop/。项目启动后监听 8080 端口。
如果在服务器本机执行 curl http://127.0.0.1:8080 能得到预期响应,但外网无法访问,先检查应用是否只绑定在本地回环地址。确认监听地址后,再查看阿里云 ECS 安全组是否按需放行 TCP 8080,以及服务器防火墙是否拦截了请求。生产环境通常可通过 Nginx 转发到应用端口,避免直接暴露不需要对外开放的服务端口。
启动失败或访问异常的检查项
- 提示 java: command not found:检查 JDK 是否安装成功,并确认 PATH 包含 JDK 的 bin 目录;修改配置后重新加载 shell 配置。
- Java 版本与项目不匹配:用 java -version 检查当前生效版本,再核对项目构建配置和启动脚本。
- systemd 服务启动失败:查看 systemctl 状态和 journalctl 日志,重点检查 JAR 路径、服务用户权限及端口占用。
- 外网无法访问:先在服务器本机测试应用,再检查监听地址、安全组规则和系统防火墙。
- 进程被系统终止:结合应用日志和服务器内存使用情况排查是否内存不足,不要在没有确认原因时盲目增大堆内存。
阿里云服务器配置 Java 环境后,部署时要把 JDK 版本、项目启动命令和网络访问条件逐项核对。项目运行稳定后,记录操作系统版本、JDK 版本、服务配置和开放端口;以后升级或迁移时,这些信息能帮助快速复现环境,也更方便排查问题。