SIGCHLD信号未全部送达signalfd问题排查

• 先明确SIGCHLD的信号合并特性
  Linux内核会合并相同的未决可靠信号，当多个子进程同时退出时，可能只发送1个SIGCHLD，而非每个子进程对应一个信号。这是正常内核行为，不是bug，核心排查点应该是收到信号后是否处理了所有已退出的子进程，而非纠结信号数量。
  排查动作：在从signalfd读到信号后，必须循环调用waitpid(-1, NULL, WNOHANG)直到返回0（无僵尸进程剩余），不能读一次信号只处理一个子进程。

• 检查signalfd的信号掩码配置
  signalfd要求目标信号必须被加入进程的信号掩码，否则信号会走默认处理逻辑（比如被忽略），无法进入signalfd。
  排查动作：

  • 核对代码中sigemptyset、sigaddset、sigprocmask(SIG_BLOCK, &mask, NULL)的调用，确保SIGCHLD被正确阻塞。
  • 确认signalfd创建时SFD_NONBLOCK参数不影响信号送达，仅控制读取是否阻塞。

• 验证pkill是否真的终止了所有子进程
  可能存在pkill匹配不全的情况：比如子进程名称不是精确的proc前缀、权限不足导致部分进程未被终止。
  排查动作：

  • 执行pkill -l proc查看实际终止的进程列表，确认proc1/proc2/proc3全部被命中。
  • 主进程启动子进程时记录PID，收到SIGCHLD后打印已回收的PID，对比是否三个PID都被处理。

• 检查signalfd的读取逻辑
  非阻塞模式下，read(signalfd_fd)返回EAGAIN仅代表当前无信号可读，但不代表没有子进程退出（可能信号已被合并）。
  排查动作：

  • 避免读到一个信号就停止处理，正确逻辑是无论读到多少个signalfd事件，都要循环调用waitpid清理所有僵尸进程。
  • 如果用poll监听signalfd，触发事件后要完整读取signalfd中的所有信号结构体（一次read可以读取多个），而非只读一个。

• 测试逐个终止子进程的场景
  不用pkill批量终止，而是逐个执行kill <proc_pid>，观察每个子进程退出时signalfd是否能触发读取。如果逐个终止能收到3个信号，说明批量终止时的信号合并是正常现象，只需调整处理逻辑即可。

• 排查是否有其他信号处理逻辑干扰
  确认主进程中没有其他代码修改SIGCHLD的处理方式，比如调用signal(SIGCHLD, SIG_IGN)或sigaction注册其他处理函数，会导致signalfd无法捕获信号。
  排查动作：搜索代码中所有涉及SIGCHLD的操作，确保只有signalfd相关的掩码配置。

内容的提问来源于stack exchange，提问作者Denis Korolev