asyncio.run()无法捕获SIGINT是因为其内部接管信号且重置行为；正确做法是手动管理事件循环，用loop.add_signal_handler()注册同步回调并create_task触发异步清理。

asyncio.run() 启动后无法捕获 SIGINT

直接在 asyncio.run() 外层用 signal.signal() 注册 SIGINT 会失效——因为 asyncio.run() 内部已接管信号，且事件循环启动后会重置部分信号行为。现象是按 Ctrl+C 时程序不进你的 handler，而是直接抛出 KeyboardInterrupt 并退出。

正确做法是让事件循环自己管理信号：

• 必须在调用 asyncio.run() 前，先获取并运行一个自定义事件循环（不能依赖 run() 的隐式循环）
• 使用 loop.add_signal_handler()，而非 signal.signal()
• add_signal_handler() 只支持 Unix 系统（Linux/macOS），Windows 下会抛 NotImplementedError

add_signal_handler 要求回调是协程还是普通函数？

add_signal_handler() 的回调必须是**普通同步函数**，不能是 async def 协程。传协程对象会直接报错：TypeError: a callable object is required。

原因：信号中断是异步的底层事件，事件循环用 sigwaitinfo() 或类似机制同步捕获，无法在信号上下文中启动协程调度器。所以你得在回调里“触发”异步逻辑：

• 用 loop.create_task() 提交清理任务（如优雅关闭连接、保存状态）
• 用 loop.stop() 或 loop.close() 控制循环生命周期
• 避免在回调里做耗时操作（如文件 I/O、网络请求），否则会阻塞信号处理

示例片段：

import asyncio
import signal
def handle_sigint():
print("SIGINT received — scheduling shutdown")
在事件循环中安排异步清理
loop.create_task(shutdown())
async def shutdown():

print("Running async cleanup...")

await asyncio.sleep(0.1)  # 模拟异步操作

loop.stop()
loop = asyncio.get_event_loop()

loop.add_signal_handler(signal.SIGINT, handle_sigint)

loop.run_forever()

为什么 SIGTERM 有时收不到？
在容器或 systemd 环境中，SIGTERM 可能被父进程（如 dockerd 或 systemd）拦截或转发失败，尤其当 Python 进程不是 PID 1 时。更隐蔽的问题是：add_signal_handler() 对 SIGTERM 的注册必须在循环启动前完成，且不能被后续代码覆盖。
                                                                        Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
验证是否生效的方法：

启动程序后，用 kill -TERM $PID 测试，观察终端输出
检查进程是否真的在监听：用 cat /proc/$PID/status | grep Sig 查看 SigBlk 和 SigCgt 字段，确认对应信号位是否被设置
若仍无效，考虑改用 signal.signal(signal.SIGTERM, ...) + loop.call_soon_threadsafe() 组合（需手动兼容）

多线程环境下 add_signal_handler 不起作用
add_signal_handler() **只对主线程的事件循环有效**。如果你在子线程中创建了独立的 asyncio.new_event_loop()，它不会自动继承主线程的信号注册，而且 Linux 下信号默认只发给主线程。
实际后果是：子线程里的 loop.add_signal_handler() 调用会静默失败（不报错但不生效），或者直接抛 RuntimeError: signal only works in main thread（取决于 Python 版本）。
解决方案很明确：

所有信号处理必须绑定到主线程的事件循环
子线程如需响应信号，应通过线程安全方式通知主线程（如 queue.Queue、threading.Event 或 loop.call_soon_threadsafe()）
避免在子线程中调用 add_signal_handler()


真正容易被忽略的是：Docker 容器中默认不转发 SIGTERM 到子进程，除非你显式用 exec 启动 Python（如 ENTRYPOINT ["python", "app.py"]），否则主进程可能只是 shell，信号根本到不了 Python 解释器。