Python中需用signal.signal()注册SIGTERM处理器,函数必须接收signum和frame两个参数;多线程下仅主线程能可靠捕获信号;应避免在处理器中执行阻塞操作,推荐设标志位由主循环处理清理。

Python中用signal.signal()注册SIGTERM处理器
Python默认不处理SIGTERM,进程收到该信号会直接退出。要自定义行为,必须显式调用signal.signal()注册回调函数。
关键点:处理器函数必须接收两个参数——signum(信号编号)和frame(当前栈帧),哪怕你不用frame也得保留形参,否则运行时报TypeError: handler() takes 1 positional argument but 2 were given。
示例:
import signal
import time
<p>def handle_sigterm(signum, frame):
print("收到 SIGTERM,正在清理...")</p><h1>这里放资源释放逻辑,比如关闭文件、断开数据库连接</h1><pre class="brush:php;toolbar:false;">exit(0)signal.signal(signal.SIGTERM, handle_sigterm)
立即学习“Python免费学习笔记(深入)”;
模拟长期运行
while True: time.sleep(1)
为什么不能在多线程里靠主线程捕获SIGTERM
POSIX规定:信号只递送给进程的**某个线程**,而Python的signal模块绑定的是“主线程”的信号处理上下文。如果主线程已退出,或信号被其他线程意外接收,signal.signal()注册的处理器可能完全不触发。
常见错误场景:
- 用
threading.Thread启动后台任务后,主线程立刻join()或结束 - 使用
concurrent.futures.ThreadPoolExecutor且未保持主线程活跃 - 在子线程里调用
signal.signal()(无效,会被忽略)
解决办法:确保主线程始终存活,并负责信号监听;所有清理逻辑统一由主线程协调,不要依赖子线程自行响应。
使用os.kill()测试SIGTERM是否生效
开发时验证信号处理是否正常,最直接的方式是另起终端发信号:
- 先查Python进程PID:
ps aux | grep your_script.py - 发送信号:
kill -TERM <pid></pid>或kill -15 <pid></pid>
注意:kill -INT <pid></pid> 发的是SIGINT(Ctrl+C),不是SIGTERM,别混淆;Docker容器内用docker kill --signal=TERM <container></container>才是等效操作。
如果没输出“收到 SIGTERM”,优先检查:是否主线程已退出、是否被其他信号(如SIGKILL)覆盖、是否脚本运行在不转发信号的环境(如某些IDE终端模拟器)。
信号处理中避免阻塞或长时间操作
操作系统对信号处理器的执行有严格限制:它运行在中断上下文中,不能安全调用大多数C库函数(如print底层可能调用write(),虽通常可用但非绝对可靠),更不能做I/O等待、加锁、分配内存等。
推荐做法:
- 处理器里只设一个标志位(如
shutdown_requested = True) - 主循环定期检查该标志,再执行清理并退出
- 避免在处理器里调用
time.sleep()、requests.get()、open()等
否则可能出现进程卡死、无法响应二次信号、甚至死锁——尤其当清理逻辑涉及线程锁或socket关闭时。
信号处理本身只是个“通知”,真正的退出节奏要由主逻辑控制。


















