
重启服务后,端口短暂出现在 ss 输出里,过一会儿又没了;再执行一次 systemctl restart,同样的过程重复发生。遇到这种故障,可以先把监听进程的生命周期查清楚。防火墙会影响连接能否到达,通常不会让本机的监听套接字凭空消失。
本文面向由 systemd 管理的 Linux 长期运行服务,示例单元名为 myapp.service、TCP 端口为 8080。请替换为实际名称与端口。容器内部应用、用户级服务以及 socket 激活服务要结合各自的管理方式判断;下面的配置片段用于说明,未在读者的生产环境中执行。
同时记录监听端口和服务状态
在端口出现和消失的两个时间点,分别执行:
sudo ss -lntp 'sport = :8080'
systemctl status myapp.service --no-pager -l
systemctl show myapp.service \
-p ActiveState -p SubState -p MainPID -p Result \
-p ExecMainCode -p ExecMainStatus -p NRestarts
ss 查看当前网络命名空间内的 TCP 监听,不包含 UDP。运行在容器或独立网络命名空间中的监听,应进入对应环境检查。具有相应权限时,输出中的 PID 能帮助确认端口是否属于目标服务。
对比结果时,重点看以下几种变化:
| 观察结果 | 接下来检查 |
|---|---|
| MainPID 反复变化,NRestarts 增长 | 退出原因、Restart 策略和每次重试的日志 |
| 状态变成 failed,出现 start-limit-hit | 前几次失败的根因及启动频率限制 |
| inactive (dead),退出码为 0 | 程序是否主动退出、启动脚本是否后台化、Type 是否匹配 |
| active (running),但目标端口消失 | 实际工作进程、监听地址、配置热更新及命名空间 |
| active (exited) | oneshot、RemainAfterExit 或包装脚本是否只完成一次性动作 |
active 不能单独证明业务可用。包装脚本还活着时,负责监听的子进程也可能已经退出;使用 RemainAfterExit=yes 时,进程结束后单元仍可显示活动。
如果部署使用 .socket 单元,端口还可能由 systemd 持有。此时应一并查看对应 socket 单元,不能仅用应用进程是否存在判断监听状态。
日志需要覆盖第一次失败
sudo journalctl -u myapp.service -b \
--since '20 minutes ago' --no-pager -o short-iso
-b 只看本次开机;若故障发生在上次开机,可按日志保留情况使用 -b -1。把时间范围调整到故障前后,避免只看到最后一次“启动太快”的报错。
需要观察重试过程时,可以短时间跟踪:
sudo journalctl -u myapp.service -f -o short-iso
按 Ctrl+C 停止日志跟踪,这不会停止服务。摘录日志前清理令牌、数据库连接串和用户数据。
Start request repeated too quickly 往往出现在多次启动失败之后。应向前查找第一条应用异常,例如配置解析失败、证书不可读、数据库连接拒绝、地址已被占用或进程被信号终止。只处理最后一条频率限制,原来的退出原因仍然存在。
若日志显示被杀进程或内存相关异常,再对照内核日志、内存限制和退出信号。不要把所有 SIGKILL 都归因于 OOM,也不要仅凭某个数字退出码认定内存耗尽。
Restart 决定退出后的动作,不负责修复程序
查看实际加载的单元及覆盖文件:
systemctl cat myapp.service
systemctl show myapp.service \
-p FragmentPath -p DropInPaths -p Type \
-p Restart -p RestartUSec \
-p StartLimitIntervalUSec -p StartLimitBurst
systemctl cat 显示磁盘上的文件,systemctl show 反映管理器当前加载的属性;文件修改后未执行 daemon-reload 时,两者可能不一致。旧版本 systemd 的部分属性名称或可见范围存在差异,应以本机 man systemd.service、man systemd.unit 为准。
常见的重启策略包括:
Restart=no:退出后不自动重启。Restart=on-failure:在非零退出、部分异常信号、超时等失败情况下自动重启。Restart=always:正常退出或异常退出通常都会自动重启,仍受其他配置及启动频率限制约束。
管理员通过 systemctl stop 主动停止服务时,不会因为 Restart=always 再被自动拉起。SuccessExitStatus=、RestartPreventExitStatus= 和 RestartForceExitStatus= 也可能改变具体退出状态的处理,排查时要查看完整单元。
对预期长期驻留的应用,Restart=on-failure 通常能覆盖崩溃恢复。但如果启动脚本把程序放到后台,然后自身以 0 退出,服务可能被判断为正常结束,此时切换重启策略只会掩盖进程管理问题。
RestartSec= 控制自动重启前等待多久。适当间隔可降低连续失败时的日志和资源压力;数据库地址写错、证书路径不存在等问题,等待更久仍然会失败。
Type 与应用运行方式要匹配
查看 ExecStart= 指向的命令和脚本,确认是否包含 nohup、末尾 & 或二次后台化。systemd 管理长期服务时,通常应让应用以前台方式运行,由 systemd 跟踪其生命周期。
Type=simple 适用于直接以前台方式运行的常见程序,但 systemd 不会等到它完成业务初始化才认为启动流程推进。Type=exec 会进一步等待执行程序的调用成功,仍不代表端口和业务已准备好;旧系统是否支持需要查看本机文档。
Type=notify 需要程序或正确实现的包装层发送就绪通知,不能只改一个 Type 值就获得就绪检测。不支持通知的程序可能一直等到启动超时。Type=forking 面向传统自行后台化的服务,通常还需要正确的 PID 跟踪方式。
下面的命令展示前台启动思路,参数仅为占位示例:
[Service]
Type=simple
ExecStart=/opt/myapp/bin/myapp --config /etc/myapp/config.yaml
不要直接把这个片段套到已有服务。尤其是通过 drop-in 替换 ExecStart= 时,通常需要先用空的 ExecStart= 清除旧值,再设置新命令;遗漏清空可能导致长期服务出现多个启动命令的配置错误。只有确认原始启动方式有问题,才应更改它。
After 约束顺序,依赖就绪需要另行确认
服务在开机时容易失败、稍后手工启动却成功,可以检查数据库、挂载和网络依赖。
[Unit]
Wants=network-online.target
After=network-online.target
这是确有启动时联网需求的客户端型应用可考虑的设置。network-online.target 的“在线”由网络管理软件定义,还取决于相应 wait-online 服务的参与;它不保证公网数据库、DNS 或第三方 API 一定可访问,也不持续监控运行中的网络状态。仅在本机接受连接的服务器通常无需为了监听端口强行等待网络在线。
对同机数据库,可以按实际耦合关系考虑依赖,例如:
[Unit]
Requires=postgresql.service
After=postgresql.service
这里的数据库单元名是示例,发行版可能使用版本化或实例化单元。After= 不会单独把另一个单元拉起;Requires= 会建立更强的启动依赖和部分停止关联,需要确认这正是业务期望。部分发行版的数据库总单元只是管理多个实例的入口,更不能把它的状态当作具体数据库已能处理查询。
应用仍应处理连接失败并进行有界重试,或通过数据库自身的就绪检测确认连接和认证。固定 sleep 10 在负载较高时仍可能不够,在依赖很快就绪时又浪费等待时间。
如果应用依赖独立数据盘,应核对挂载单元;必要时评估 RequiresMountsFor=/实际数据路径。它可以添加访问该路径所需的挂载依赖,但不会替你确认远端存储中的业务数据完整或应用账号可读写。
用局部覆盖调整重试,并保留回滚路径
确认首次失败原因已修复,再决定是否调整恢复策略。修改前记录 systemctl cat myapp.service 的输出,备份已有覆盖文件,保留原始路径与权限。不要直接编辑 /usr/lib/systemd/system 或 /lib/systemd/system 中的软件包文件,升级可能覆盖修改。
例如,确认目标路径没有同名文件后,为服务创建一个独立的 /etc/systemd/system/myapp.service.d/90-restart-policy.conf,写入:
[Unit]
StartLimitIntervalSec=60s
StartLimitBurst=5
[Service]
Restart=on-failure
RestartSec=5s
目录或文件名均为示例,创建前先检查现有 drop-in。覆盖文件按规则合并,后面的同类配置可能再次覆盖这些值。示例表示在指定时间窗口内限制启动次数,手动启动也计入;它没有保证服务失败后能永远持续重试。
生产环境重启会中断该服务的连接和正在处理的任务,应选择维护窗口,或在具备冗余时先从流量中摘除实例。完成修改后执行:
sudo systemctl daemon-reload
sudo systemctl reset-failed myapp.service
sudo systemctl restart myapp.service
daemon-reload 重新加载单元配置,本身不重启应用。reset-failed 会清除失败状态和启动频率计数,方便在修复原因后重新尝试。达到启动频率限制的服务,不应假设窗口过去就会自行恢复;需要结合实际触发机制重新启动。
如果服务持续失败并影响数据库或其他依赖,使用 sudo systemctl stop myapp.service 暂停该服务的重试,保留日志后处理根因。恢复时再启动。
回滚时,仅移除本次新增的覆盖文件;如果修改的是已有文件,恢复其备份。然后重新执行 daemon-reload,在维护窗口重启并验证。不要为撤销一项设置直接清空整个 drop-in 目录,也不要贸然使用会一并移除其他本地定制的操作。
验证要覆盖原来失败的时间窗口
修改完成后检查:
systemctl is-active myapp.service
systemctl show myapp.service -p MainPID -p NRestarts -p Result
sudo ss -lntp 'sport = :8080'
sudo journalctl -u myapp.service --since '5 minutes ago' --no-pager
如果应用提供适合本机调用的健康检查接口,可再执行:
curl --fail --show-error --max-time 5 http://127.0.0.1:8080/health
地址、协议与路径需要按应用调整。接口若需要认证,应使用受控凭证;404 或鉴权失败不能直接证明服务不健康。还应完成一次代表实际业务的请求,并确认监听地址符合预期,避免修复后意外扩大公网暴露范围。
观察时间至少覆盖原先出现故障的周期,检查 MainPID 是否稳定、NRestarts 是否继续增长以及错误是否重现。若问题只在开机发生,普通服务重启不能替代开机验证;应在获得维护安排后验证完整启动过程。
端口持续监听、业务请求正常、原来的失败日志不再出现,才算这次修复有了证据。重启策略可以应对偶发故障,应用持续退出仍需要落实到具体异常和依赖条件。
官方参考资料
核验日期:2026 年 11 月 13 日。在线文档可能包含较新版本功能,配置前请对照本机 systemd 版本和随附手册。




