systemd通过信号和超时配置实现服务优雅停止,关键参数包括execstop、timeoutstopsec、killsignal。1. 优雅停止指通知服务处理完任务再关闭,systemd默认发sigterm并等待90秒,若未退出则发sigkill。2. 配置项中execstop定义停止命令,timeoutstopsec设等待时间,killsignal指定初始信号,默认为sigterm。3. 验证方法为重启服务后查看日志是否有stoppng timed out或killed记录。4. 常见建议:服务不响应sigterm可改用sigint;timeout需按实际调整;避免依赖默认值,应显式配置以匹配服务特性。
服务停止时如果直接“咔”一下断掉,很容易导致数据丢失、请求中断或者客户端报错。想要让服务优雅地退出,systemd 提供了比较灵活的配置方式,关键就在于信号和超时时间的设置。
1. 什么是优雅停止?
所谓“优雅停止”,指的是在关闭服务时,先通知服务进程做好清理工作,比如处理完正在执行的任务、释放资源、保存状态等,而不是直接强制杀掉进程。
systemd 默认发送 SIGTERM 信号给服务,然后等待一段时间(默认是90秒),如果还没退出就发 SIGKILL 强制终止。但这个流程是否能真正实现“优雅”,还得看服务本身是否对 SIGTERM 做了处理,并且 systemd 的配置是否合适。
2. 配置优雅停止的关键参数
在 .service 文件中,有三个关键选项与优雅停止有关:
- ExecStop=:定义用于关闭服务的命令。
- TimeoutStopSec=:指定从开始停止到强制杀死进程的时间上限。
- KillSignal=:指定第一次发送的信号,默认是 SIGTERM。
举个例子:
[Service] ExecStart=/usr/bin/myserver ExecStop=/usr/bin/pkill myserver TimeoutStopSec=30s KillSignal=SIGTERM
这样配置后,systemd 会在停止服务时运行 /usr/bin/pkill myserver,然后最多等待30秒,如果没退出再发 SIGKILL。
3. 如何验证你的配置是否生效?
可以手动测试一下服务的停止行为:
-
修改完 .service 文件后 reload systemd:
sudo systemctl daemon-reload
-
重启服务:
sudo systemctl restart myservice
-
然后尝试停止服务并观察日志:
sudo systemctl stop myservice journalctl -u myservice --since "1 minute ago"
看看日志里有没有出现 Stopping timed out 或者 Killed,这说明服务没有及时响应停止信号。
4. 常见问题和建议
-
服务不响应 SIGTERM?
可以试试换一个信号,比如 SIGINT,有些程序(比如 Node.JS 应用)更倾向于监听 SIGINT。
-
Timeout 设置太短或太长?
根据服务的实际处理能力来设定合理的等待时间。例如 Web 服务可能需要几秒钟处理完当前请求,而数据库连接池则可能需要更久。
-
不要依赖默认值
每个服务的行为不同,最好显式配置这些参数,而不是依赖 systemd 默认的 SIGTERM + 90s。
基本上就这些,优雅停止的核心在于合理设置信号和等待时间,配合服务本身的处理逻辑,才能真正做到“善始善终”。