Ubuntu 关机要等 90 秒?Python asyncio 服务不肯接 SIGTERM 的排查与修复

Fri, 19 Jun 2026 10:58:00 +0800

先说结论

这台升级到 24.04 的代理机,关机变成了一件折磨人的事:systemctl reboot 之后,SSH 不掉、灯不灭,要干等 90 秒 才进入真正的 shutdown 流程。journalctl 里很明确:smart-proxy.service: State 'stop-sigterm' timed out. Killing.——systemd 给了 SIGTERM,等 90 秒没人响应,只能 SIGKILL 强杀。

根因不是 systemd 的错,也不是 Ubuntu 的错,是 Python 的 asyncio 服务在收到 SIGTERM 后,没有真正去结束它的子任务——它正卡在某个 socket.recv 上,Python 解释器根本不主动去看"有人叫我走"。

修复分两步,缺一不可:(1) 给两个 Python unit 写 systemd drop-in,把 TimeoutStopSec 从默认的 90s 缩到 20s;(2) 在 Python 服务里主动遍历 asyncio.all_tasks(),收到 SIGTERM 后把所有 in-flight 的 handler cancel() 掉,再用 asyncio.wait_for(self.stop(), timeout=10) 包一层做兜底。改完之后,同样一次 reboot,从 90 秒掉到 1 秒。

Asyncio on 魔都水滴

Ubuntu 关机要等 90 秒?Python asyncio 服务不肯接 SIGTERM 的排查与修复