systemd启动次数过多,先查第一次退出
服务启动失败,日志最后只剩Start request repeated too quickly或start-limit-hit时,频繁点restart往往只会再撞上限制。systemd是在阻止短时间内过多启动;真正需要修复的错误,通常出现在前面某次退出时。
下面针对Linux上的系统级常驻服务,在服务器管理员终端执行。myapp.service是示例,替换成已确认的实际服务单元。用户级服务应由对应用户使用systemctl --user管理,不要混用系统级命令。
先保留失败现场,再读最早的原因
systemctl status myapp.service --no-pager -l
sudo journalctl -u myapp.service --since '30 minutes ago' --no-pager
systemctl show myapp.service -p Result -p Restart -p RestartUSec -p NRestarts -p StartLimitIntervalUSec -p StartLimitBurst
时间范围覆盖实际故障即可,必要时扩大;日志多时可去掉--no-pager分页阅读。先保存这些结果,再进行停止、重置或重新启动。别只截最后一条限频提示,应沿时间顺序找到第一次异常退出、启动前命令失败或超时。
常见线索包括配置解析失败、端口冲突、目录权限不足、依赖不可用。如果是203/EXEC或200/CHDIR,按systemd执行程序与工作目录错误检查。若每次都是成功退出但立即重启,还应确认程序是否本来就是一次性任务,却被按常驻服务设置了重启策略。
NRestarts反映自动重启次数,不是启动频率窗口中的总次数。手动反复start也会受启动频率限制,不能根据NRestarts很小就排除限频。重置前保存状态,才方便与后续观察比较。
启动窗口与重启间隔,不是同一个参数
| 配置项 | 所在节 | 控制什么 |
|---|---|---|
| StartLimitIntervalSec | [Unit] | 统计启动次数的时间窗口 |
| StartLimitBurst | [Unit] | 窗口内允许的启动次数 |
| RestartSec | [Service] | 自动重启前等待的时间 |
配置中的Sec与show输出的USec属性名并不完全相同,上面的查询命令读取当前管理器已加载的值。不要照搬网上某个固定默认次数;发行版、管理器设置和服务自身配置可能不同。需要确认配置来源时执行:
systemctl cat myapp.service
cat会显示主文件及附加配置,便于查出是谁覆盖了设置;它读取的是磁盘文件,刚编辑但尚未daemon-reload的内容,不一定已经成为当前生效值。涉及环境变量或凭据的内容,对外提交前要脱敏。
提高Burst或把Interval设成0,只是放宽或关闭保护,不会修好启动错误。调整RestartSec可以降低自动尝试频率,但也要根据程序恢复需要安排,不能代替应用自身的重试和依赖处理。
修好原因以后,只恢复这个服务
若目标仍在反复尝试,且业务允许中断,可先正常停止目标服务,避免边改边拉起:
sudo systemctl stop myapp.service
如果停止后仍有人重新发起start,要查定时器、socket、部署脚本或其他守护来源,参照进程结束后又出现的排查方法,不要只盯着Restart参数。先协调相关触发任务,再处理应用本身。
修改前备份实际文件,只改已经确认的问题;应用配置优先用该软件提供的检查方式验证。改了unit或附加配置,才需要执行下面这条让systemd重新读取定义。它不会重新加载应用自己的配置,也不能证明程序已能正常运行:
sudo systemctl daemon-reload
确认失败原因已处理、依赖已就绪,并允许该服务重新开展业务后,再执行:
sudo systemctl reset-failed myapp.service &&
sudo systemctl start myapp.service
reset-failed会清除目标单元的失败状态、启动频率计数和服务重启计数,但它本身不会启动应用。保留明确的服务名,不要不带参数地清除所有服务的失败记录。单纯等时间窗口过去后,可以再次尝试启动;不能假设原来的失败服务一定会自行恢复。
恢复标准是稳定运行,不是清掉红字
systemctl show myapp.service -p ActiveState -p SubState -p Result -p NRestarts
sudo journalctl -u myapp.service --since '5 minutes ago' --no-pager
对本应常驻的服务,结合实际类型确认状态正常,观察超过此前退出时长和相关启动窗口,NRestarts不再持续增长,日志也没有原来的错误。然后执行一次与该服务有关的只读业务检查。
如果再次触发限频,保留这轮首次退出的日志继续定位,不要写循环不断reset-failed加start。服务暂时启动成功,只说明这一次启动完成;依赖、配置和真实请求都正常,才是本次修复的验收结果。