本文介绍如何通过进程组（process group）机制，确保 python 主进程捕获到 sigint（如 ctrl+c）后，能立即、可靠地将该信号转发给所有派生的 c/c++ 子进程，避免信号被延迟处理或丢失。
本文介绍如何通过进程组（process group）机制，确保 python 主进程捕获到 sigint（如 ctrl+c）后，能立即、可靠地将该信号转发给所有派生的 c/c++ 子进程，避免信号被延迟处理或丢失。
在使用 Python 调用 C/C++ 库（如通过 PyBind11、Cython 或 ctypes）并间接启动后台子进程时，一个常见问题是：当用户按下 Ctrl+C，Python 的 signal.SIGINT 处理器不会立即触发，而是要等到 C++ 代码执行返回、控制权交还给 Python 解释器后才响应。此时，C 子进程往往已脱离主进程的信号感知范围，导致无法及时终止，出现“卡死”或资源泄漏。
根本原因在于：默认情况下，子进程与父进程处于同一会话（session），但不一定属于同一进程组；而 os.kill() 只能向单个 PID 发送信号，无法批量触达所有衍生进程。更关键的是，C/C++ 层可能屏蔽、忽略或未正确传递 SIGINT，导致信号“消失”。
✅ 正确解法是 显式创建独立进程组，并将所有子进程纳入其中，再由 Python 统一广播信号：
✅ 核心步骤
-
在 Python 主进程启动初期调用
os.setpgrp()—— 创建新进程组，并使当前进程成为组长（PGID = 当前 PID）； -
确保 C/C++ 库 spawn 的子进程继承该进程组（默认行为，只要不调用
setsid()或显式setpgid(0, 0)即可）； -
注册自定义
SIGINT处理器，使用os.killpg(0, signal.SIGINT)向整个进程组广播信号（0表示当前进程组）； - 在信号处理器内临时忽略同类型信号，防止重入导致递归崩溃。
✅ 完整可运行示例
import os
import signal
import sys
import time
from typing import NoReturn
# ? 关键：创建独立进程组（必须在 spawn 任何子进程前执行）
os.setpgrp()
def handle_sigint(signum: int, frame) -> NoReturn:
# 防止信号重入：立即忽略同类型信号
signal.signal(signum, signal.SIG_IGN)
print(f"\n[INFO] Forwarding SIGINT ({signum}) to entire process group...")
try:
# 向当前进程组发送信号（0 表示本组）
os.killpg(0, signum)
except ProcessLookupError:
# 进程组已空（所有子进程已退出），安全忽略
pass
except PermissionError:
print("[WARN] Permission denied sending signal to process group — check privileges.")
sys.exit(0)
# 注册信号处理器
signal.signal(signal.SIGINT, handle_sigint)
# ? 注意：此处模拟 C/C++ 库长期运行逻辑（如阻塞式计算、IO 等）
print("Starting long-running C-bound task... (Press Ctrl+C to interrupt)")
try:
# 模拟不可中断的 C 层调用（实际中此处为 Python binding 调用 C++ 函数）
while True:
time.sleep(1)
except KeyboardInterrupt:
# 此处不会触发 —— 因为 SIGINT 已被自定义 handler 拦截
pass⚠️ 重要注意事项
-
os.setpgrp()必须在任何子进程创建之前调用，否则已有子进程不属于新组； - 若 C/C++ 代码中调用了
setsid()（如守护进程化），会脱离进程组，需改用setpgid(0, os.getpgrp())显式加入； -
os.killpg(0, sig)中的0是 magic value，代表“当前进程组”，非字面意义的 PID 0； - 在容器或 systemd 环境中，需确认 init 进程未拦截或重定向信号（如
docker run --init可缓解）； - 生产环境建议同时监听
SIGTERM并做相同处理，提升健壮性。
通过该方案，无论子进程是直接 fork/exec 还是经由 C++ 库间接启动，只要它们共享同一进程组，即可实现信号的原子性广播，真正达成“一键中止全链路”的运维体验。
立即学习“Python免费学习笔记（深入）”；
