如何通过Node.js child_process spawn追踪子进程的close事件？

当你用child_process.spawn启动的进程立刻退出，但它启动的次级子进程仍在后台运行时，核心问题是初始进程与次级进程的关联被切断了。以下是几种可行的解决思路：

1. 让初始进程等待次级进程退出 #

如果初始进程是你可修改的脚本或程序，最简单的办法是让它不要立刻终止，而是等待所有次级子进程结束后再退出：

• 若是Shell脚本，在启动次级进程后添加wait命令：

  # 启动次级进程并后台运行
  ./secondary-process &
  # 等待该进程结束
  wait $!
  

  这样初始进程的close事件会在次级进程退出后才触发，你只需监听初始进程的close事件就能感知所有进程结束。
• 若是自定义程序，在代码中添加逻辑，监控次级进程的PID并等待其退出。

2. 利用进程组追踪整个进程树 #

Unix/Linux和Windows系统都支持进程组概念，你可以通过追踪整个进程组的状态来判断所有子进程是否退出：

Unix/Linux 实现方案 #

启动初始进程时将其放入独立进程组，定时检查该进程组下是否还有存活的子进程：

const { spawn } = require('child_process');

// 启动初始进程，创建独立进程组
const child = spawn('./initial-process', [], {
  detached: true,
  stdio: 'ignore'
});
child.unref();

// 定时检查子进程状态
const checkInterval = setInterval(() => {
  // 使用pgrep查找所有父进程为初始进程的子进程
  const pgrep = spawn('pgrep', ['-P', child.pid.toString()]);
  pgrep.on('exit', (code) => {
    // pgrep返回非0表示无存活子进程
    if (code !== 0) {
      console.log('所有次级子进程已关闭');
      clearInterval(checkInterval);
    }
  });
}, 1000);

Windows 实现方案 #

Windows可通过wmic命令查询子进程：

const { spawn } = require('child_process');

const child = spawn('initial-process.exe', [], {
  detached: true,
  stdio: 'ignore'
});
child.unref();

const checkInterval = setInterval(() => {
  const wmic = spawn('wmic', ['process', 'where', `parentprocessid=${child.pid}`, 'get', 'processid']);
  let output = '';
  wmic.stdout.on('data', (data) => output += data.toString());
  wmic.on('exit', () => {
    // 过滤空行和表头，判断是否有子进程PID
    const pids = output.trim().split('\n').slice(1).filter(pid => pid.trim());
    if (pids.length === 0) {
      console.log('所有次级子进程已关闭');
      clearInterval(checkInterval);
    }
  });
}, 1000);

3. 避免次级进程被"分离" #

如果初始进程启动次级进程时设置了detached: true，会导致Node.js失去对次级进程的追踪。除非必须，否则不要给次级进程设置该参数，或让次级进程继承初始进程的会话组，保持关联。

4. 借助第三方库简化逻辑 #

如果不想自己编写跨平台的进程树查询逻辑，可使用ps-tree库获取进程的所有子进程，再逐个监听它们的exit事件：

const { spawn } = require('child_process');
const psTree = require('ps-tree');

const child = spawn('./initial-process');

child.on('exit', () => {
  psTree(child.pid, (err, children) => {
    if (err) throw err;
    const childPids = children.map(c => c.PID);
    let remaining = childPids.length;
    
    if (remaining === 0) {
      console.log('所有次级子进程已关闭');
      return;
    }
    
    childPids.forEach(pid => {
      try {
        // 检查进程是否存活
        process.kill(pid, 0);
        // 监听进程退出
        const subChild = spawn('waitpid', [pid]);
        subChild.on('exit', () => {
          remaining--;
          if (remaining === 0) {
            console.log('所有次级子进程已关闭');
          }
        });
      } catch (e) {
        remaining--;
      }
    });
  });
});

注意：需先通过npm install ps-tree安装该库。

内容的提问来源于stack exchange，提问作者Alon Amir