signal.signal() 必须在主线程中注册，子线程调用会抛出 ValueError；所有信号处理注册须在主线程启动任何线程前完成，通过 flag、队列或 threading.Event 协调多线程响应。
signal.signal() 必须在主线程中注册
Python 的 signal 模块只支持在主线程中设置信号处理器，子线程调用 signal.signal() 会直接抛出 ValueError: signal only works in main thread。这不是 bug，而是 POSIX 信号模型的限制：信号是进程级的，但 Python 的信号处理机制绑定到主线程的执行上下文。
常见错误是试图在 threading.Thread 启动后单独注册信号——这注定失败。正确做法是：所有 signal.signal() 调用必须在 if __name__ == '__main__': 块内、任何线程启动之前完成。
- 主线程负责接收信号并分发逻辑（比如设个
flag或发queue.put()） - 工作线程通过轮询或阻塞队列响应主线程的协调指令，而非直接处理信号
- 若需多线程感知中断，用
threading.Event配合signal.pause()或signal.sigwait()（后者需 Linux + Python 3.3+）
SIGINT 和 SIGTERM 处理要区分场景
SIGINT（Ctrl+C）和 SIGTERM（kill -15）都常用于请求程序退出，但语义不同：前者是交互式中断，后者是系统级终止请求。硬编码统一处理容易出问题。
例如，某些守护进程收到 SIGTERM 应立即释放资源并退出，而 SIGINT 可能只触发优雅降级（如暂停新请求、等待当前任务完成）。忽略这点会导致 systemd 等管理器判定服务超时失败。
立即学习“Python免费学习笔记（深入）”；
- 用不同回调函数分别注册：
signal.signal(signal.SIGINT, handle_interrupt)和signal.signal(signal.SIGTERM, handle_terminate) - 避免在处理器里做耗时操作（如网络请求、文件写入），信号处理函数应尽可能轻量，否则可能被二次信号中断或导致死锁
- 若需清理资源，优先使用
atexit.register()补充，而非全压在信号处理器里
不可重入函数在信号处理器中要特别小心
Python 信号处理器运行在异步中断上下文中，此时 C 层的大多数标准库函数（包括 print()、logging.info()、sys.stdout.write()）都不是异步信号安全的。在处理器里调用它们可能引发 RuntimeError 或静默崩溃。
典型错误现象：程序偶尔卡死、日志丢失、或报错 Interrupted system call。根本原因是信号中断了正在执行的系统调用，而 Python 的 I/O 封装未做充分防护。
- 安全做法：只修改
int/bool类型的全局变量（如running = False），或向os.kill(os.getpid(), signal.SIGUSR1)这类纯系统调用发送信号 - 真要输出调试信息，改用
os.write(2, b"msg\n")—— 它是异步信号安全的底层写入 - 绝对不要在信号处理器里调用
time.sleep()、threading.Lock.acquire()或任何带锁/阻塞的操作
Python 3.3+ 推荐用 signal.sigwait() 替代传统 handler
传统 signal.signal() + 回调模式容易和主逻辑竞争状态，尤其在复杂循环中。Python 3.3 引入的 signal.sigwait() 提供同步、可预测的信号捕获方式，更适合主循环控制流。
它把信号当作“事件”来等待，规避了异步中断带来的重入风险，且能精确指定等待哪些信号。但注意：调用前必须先用 signal.pthread_sigmask(signal.SIG_BLOCK, {sig}) 屏蔽对应信号，否则可能漏收。
- 示例关键步骤：
signal.pthread_sigmask(signal.SIG_BLOCK, {signal.SIGINT, signal.SIGTERM})→ 主循环中sig = signal.sigwait({signal.SIGINT, signal.SIGTERM}) - 该方式天然适合 while 循环驱动的服务（如 Web server 主循环），每轮迭代前检查信号，逻辑清晰无竞态
- Windows 不支持
sigwait()，仅限 Unix-like 系统；且要求信号已被阻塞，否则行为未定义
信号处理最麻烦的从来不是注册那几行代码，而是确保信号到达时，你的数据结构没被撕开、锁没死住、日志没写一半就崩。别信“简单加个 handler 就行”的直觉，先想清楚信号进来那一刻，你正在做什么。
