在独立服务器上部署Java 17应用,如何配置服务托管与异常重启?
本文以 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 则限制短时间内的连续启动次数,避免配置错误时无限快速重启。

-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



