Linux 与服务器运维 / 系统课时

start-limit-hit 是怎么产生的

start-limit-hit 是怎么产生的

服务连续崩溃时,systemd 不会无限制地立即重启。它会统计一段时间内的启动次数,超过阈值后拒绝新的启动请求。本节用一个可控的失败服务复现 start-limit-hit,再演示确认根因、修复配置和重置限制的正确顺序。

学习目标

  • 解释 StartLimitIntervalSec= 与 StartLimitBurst= 如何共同触发启动限流
  • 用 systemctl show 区分普通进程失败与 start-limit-hit
  • 在修复真实故障后安全地使用 systemctl reset-failed

限制的是启动频率,不只是重启次数

StartLimitIntervalSec= 定义统计窗口,StartLimitBurst= 定义窗口内允许的启动次数。由 Restart= 触发的自动重启同样会形成新的启动尝试,因此一个“启动即退出”的服务很容易在短时间内耗尽额度。

例如窗口为 10 秒、上限为 3 次时,前三次启动都迅速失败,后续启动请求就会被 systemd 拒绝。此时进程本身甚至不会再次执行,服务结果会表现为 start-limit-hit。

频繁失败触发 systemd 启动限流的过程

用失败服务复现 start-limit-hit

下面的实验需要一台以 systemd 作为 PID 1 的 Linux 主机,并需要 sudo 权限。测试服务每次启动都执行 /bin/false,因此会立即以失败状态退出。

bash
sudo tee /etc/systemd/system/demo-start-limit.service >/dev/null <<'EOF'
[Unit]
Description=Demo service for systemd start limit
StartLimitIntervalSec=10s
StartLimitBurst=3

[Service]
Type=simple
ExecStart=/bin/false
Restart=on-failure
RestartSec=100ms
EOF

sudo systemctl daemon-reload
sudo systemctl reset-failed demo-start-limit.service
sudo systemctl start demo-start-limit.service
sleep 1
systemctl show demo-start-limit.service -p ActiveState -p SubState -p Result

预期输出

text
ActiveState=failed
SubState=failed
Result=start-limit-hit

如果刚好在限制触发前查询,短暂状态可能不同;等待自动重启耗尽额度后再次执行最后一条 systemctl show 即可。此实验的关键不是“出现 failed”,而是 Result=start-limit-hit,它说明 systemd 已经拒绝继续启动。

先找第一次失败,再处理限流

start-limit-hit 往往是第二层现象。真正的第一层故障通常发生在更早的启动尝试中,例如可执行文件不存在、配置解析失败、权限不足、端口被占用,或程序自身主动退出。

排查时应先查看当前状态和该单元的日志,重点寻找第一次异常退出附近的错误,而不是只盯着最后一条“启动过于频繁”的消息。systemctl status demo-start-limit.service 适合快速看状态,journalctl -u demo-start-limit.service 适合向前追溯完整失败链路。

修好根因后再重置并启动

在这个实验里,根因就是 ExecStart=/bin/false。把它改成持续运行的命令,然后重新加载 unit、重置失败状态并启动,才能验证服务已经真正恢复。

bash
sudo sed -i 's|ExecStart=/bin/false|ExecStart=/usr/bin/sleep infinity|' /etc/systemd/system/demo-start-limit.service
sudo systemctl daemon-reload
sudo systemctl reset-failed demo-start-limit.service
sudo systemctl start demo-start-limit.service
systemctl is-active demo-start-limit.service

预期输出

text
active

实际服务也应遵循同样顺序:先从日志确认最早的失败原因,修复配置、依赖或程序错误,再执行 reset-failed 并启动。否则只是把计数器清零,服务仍会再次崩溃并重新触发 start-limit-hit。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

start-limit-hit 是怎么产生的

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通