在独立服务器上部署Java 17应用,如何配置服务托管与异常重启?

发布人:A5数据发布时间:2026-11-16 10:00阅读量:16

本文以 Ubuntu Server 22.04/24.04、systemd 和可执行 JAR 为例,说明如何让 Java 17 应用由系统托管,并在进程异常退出时自动重启。核心做法是使用专用系统账户运行应用,通过 systemd 管理启动、停止、日志和重启策略;示例中的端口、JAR 名称和 JVM 内存参数需要按应用实际情况调整。

操作前准备好服务器 sudo 权限、可用的 Java 17 运行环境、应用 JAR 包,以及应用需要的配置和外部依赖。下文假设应用监听本机 8080 端口;如果应用端口或健康检查路径不同,应替换相应示例。java -jar 适用于可执行 JAR,不适用于需要另行指定 classpath 或启动类的项目。

Java应用长期运行所需的计算、存储与网络资源,A5idc数据提供香港、美国、日本等地区的物理服务器方案,涵盖不同CPU平台、内存配置及SSD或NVMe存储,并有相应线路选择,可为企业网站、业务后台、接口服务和数据库等场景提供部署所需的硬件基础。

一、准备运行环境

先确认系统版本和可用磁盘、内存,再安装 Java 17 运行时。以下命令适用于 Ubuntu:

lsb_release -a
free -h
df -h /

sudo apt update
sudo apt install -y openjdk-17-jre-headless
java -version

java -version 应显示 Java 17。若系统提示找不到该软件包,先检查发行版版本和软件源配置,不要直接下载来源不明的 JDK 安装包。

建立专用账户和应用目录。服务账户不需要交互式登录权限;应用文件由 root 管理,服务进程只读取 JAR,并在自己的状态目录中保存运行时数据。

sudo useradd --system --no-create-home --shell /usr/sbin/nologin myapp
sudo install -d -o root -g root -m 0755 /opt/myapp/releases
sudo install -d -o myapp -g myapp -m 0750 /var/lib/myapp

如果系统提示 myapp 用户已存在,先用 id myapp 核实账户用途,不要重复创建或修改已有账户。/var/lib/myapp 仅供应用写入;日志默认交给 systemd 的 journal 收集。

二、安装应用并配置服务

1. 放置可执行 JAR

将构建好的 JAR 上传到服务器。例如,在本地执行:

scp target/myapp.jar user@服务器地址:/tmp/myapp.jar

在服务器上安装到带版本号的发布目录,并创建当前版本链接:

sudo install -o root -g root -m 0644 \
  /tmp/myapp.jar /opt/myapp/releases/app-1.0.0.jar

sudo ln -s /opt/myapp/releases/app-1.0.0.jar /opt/myapp/current.jar

使用版本化文件可以保留旧包,避免更新时覆盖唯一副本。确认文件和链接指向正确:

ls -l /opt/myapp/current.jar
ls -l /opt/myapp/releases/

输出应显示 current.jar 指向刚安装的 JAR。应用账户应能读取这些文件;如果访问权限异常,先检查目录权限和属主,不要通过将目录改为全局可写来绕过问题。

2. 准备可选环境配置

如果应用从环境变量读取配置,可以创建受限权限的配置文件:

sudo install -d -o root -g root -m 0750 /etc/myapp
sudo install -o root -g root -m 0600 /dev/null /etc/myapp/myapp.env
sudoedit /etc/myapp/myapp.env

文件内容按应用约定填写,例如:

SPRING_PROFILES_ACTIVE=prod

这只是 Spring Boot 应用可能使用的配置项,其他应用应填写自身支持的变量。systemd 环境文件不是 shell 脚本,不要写 export。如果其中包含密码或密钥,保持文件权限收紧,并注意拥有服务器管理权限的用户仍可能读取这些内容。

3. 创建 systemd 单元

创建服务文件:

sudo tee /etc/systemd/system/myapp.service >/dev/null <<'EOF'
[Unit]
Description=My Java Application
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=5

[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/var/lib/myapp
EnvironmentFile=-/etc/myapp/myapp.env
ExecStart=/usr/bin/java -Xms256m -Xmx768m -jar /opt/myapp/current.jar
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

这里的 Restart=on-failure 表示进程异常退出时由 systemd 尝试重启;正常退出或管理员执行 systemctl stop 不会因此被不断拉起。RestartSec=5s 为重启留出短暂间隔,StartLimitIntervalSec 和 StartLimitBurst 则限制短时间内的连续启动次数,避免配置错误时无限快速重启。

二、安装应用并配置服务|3. 创建 systemd 单元配图

-Xms256m -Xmx768m 是示例参数,不是固定推荐值。设置堆上限时,要给操作系统、线程栈、直接内存及同机其他服务留出空间。若服务器总内存只有 2 GB,应用堆就不应接近 2 GB;应结合应用负载和整机可用内存调整。

保存后先检查服务文件,再加载并启动:

sudo systemd-analyze verify /etc/systemd/system/myapp.service
sudo systemctl daemon-reload
sudo systemctl enable --now myapp

如果 systemd-analyze verify 报错,先修正文件后再启动。enable --now 会同时设置开机启动并立即启动服务。

三、逐项验证启动结果

先查看 systemd 状态:

sudo systemctl status myapp --no-pager
sudo systemctl is-enabled myapp
sudo systemctl is-active myapp

正常情况下,服务应显示为 active (running),开机启动状态应为 enabled。如果服务退出,状态信息通常会显示退出码或最近的错误摘要;下一步查看完整日志,而不是反复执行重启命令。

查看本次启动以来的服务日志:

sudo journalctl -u myapp -b --no-pager -n 100

实时观察新日志:

sudo journalctl -u myapp -f

如果应用配置为监听 8080 端口,可检查端口和本机 HTTP 响应:

sudo ss -lntp | grep ':8080'
curl -i --max-time 5 http://127.0.0.1:8080/

curl 返回什么取决于应用实际路由:根路径不存在时,收到 404 不一定代表服务没启动。应优先访问应用已实现的健康检查地址,并确认响应符合应用预期。如果端口未监听,则结合启动日志检查应用是否启动完成、端口是否配置正确,或是否被其他进程占用。

服务日志进入 journal 后,可以按时间和服务名检索。若应用还自行写文件日志,应确认写入目录存在且 myapp 用户有权限;不要假设 systemd 会自动轮转应用自己创建的所有日志文件。

四、异常重启与常见故障处理

进程反复退出

先查看最近日志、退出状态和重启次数:

sudo journalctl -u myapp -b --no-pager -n 150
sudo systemctl show myapp -p Result -p ExecMainStatus -p NRestarts

日志中出现配置缺失、连接外部依赖失败或启动参数错误时,应先修正对应问题,再观察服务是否稳定。若退出码为 0,应用可能是正常结束而非故障退出;此时 Restart=on-failure 不会重新启动它,需要确认应用是否本应作为长期运行的服务。

如果看到 Start request repeated too quickly,说明服务在限定时间内连续启动失败,已触发启动频率限制。先排除导致退出的问题,再清除失败状态并启动:

sudo systemctl reset-failed myapp
sudo systemctl start myapp

未修复原因前反复执行 reset-failed 只会重新开始失败循环,不能解决根因。

端口占用或无法访问

检查实际监听端口及占用情况:

sudo ss -lntp

若应用日志提示端口已被占用,先确认占用进程的用途,再决定是否调整应用端口或停止冲突服务。不要直接结束未知进程。若本机 curl 能访问,但远程客户端无法访问,进一步核对应用监听地址、服务器防火墙和云平台网络规则。只开放业务确实需要的端口;若公网入口需要 HTTPS,应使用适合该环境的 TLS 配置,不要将未加密的管理接口直接暴露在公网。

内存不足或 JVM 异常

Java 堆内存不足时,应用可能在日志中报告 OutOfMemoryError;整机内存压力过大时,进程也可能被内核终止。可先查看内存和内核日志:

free -h
sudo journalctl -k -b --no-pager | grep -i -E 'oom|killed process'
sudo journalctl -u myapp -b --no-pager -n 100

不要仅凭一次异常就盲目增大 -Xmx。JVM 除堆外还需要本地内存;堆上限过高可能加重整机内存压力。应结合服务器剩余内存、同机服务和应用负载调整,并在变更后重新观察日志与运行情况。

五、更新、验收与回滚

更新时保留当前发布文件,先安装新版本,再切换 current.jar。下面以已有 app-1.0.0.jar、待发布的 app-1.1.0.jar 为例:

sudo install -o root -g root -m 0644 \
  /tmp/myapp-1.1.0.jar /opt/myapp/releases/app-1.1.0.jar

sudo ln -s /opt/myapp/releases/app-1.1.0.jar /opt/myapp/current.jar.next
sudo mv -Tf /opt/myapp/current.jar.next /opt/myapp/current.jar
sudo systemctl restart myapp

切换后按前述方法检查 systemctl status、journal、监听端口和应用健康检查。保留旧 JAR,待新版本运行符合预期后再按内部保留周期清理。若更新还涉及数据库结构变更,单纯切回旧 JAR 不一定能恢复兼容性,应先准备数据库备份和独立的迁移回退方案。

出现新版本启动失败或关键检查不通过时,可将链接切回旧版本:

sudo ln -s /opt/myapp/releases/app-1.0.0.jar /opt/myapp/current.jar.next
sudo mv -Tf /opt/myapp/current.jar.next /opt/myapp/current.jar
sudo systemctl restart myapp

再次确认服务状态、日志和健康检查。若本次变更还修改了服务文件,应先备份原文件;回退时恢复备份,再执行 sudo systemctl daemon-reload 并重启服务。首次部署需要撤销时,可先执行 sudo systemctl disable --now myapp 停止并取消开机启动,确认没有其他服务依赖后再决定是否清理账户和文件。

验收时逐项确认:Java 版本为 17;服务账户和 JAR 权限符合预期;服务已启用且处于运行状态;应用端口和健康检查响应正确;异常退出后能按策略重启,连续失败会受到频率限制;旧版本文件和配置备份仍可用于回滚。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9685.html

相关推荐