如何使用Jest测试Node.js spawn生成的子进程是否满足detached和unref()要求

核心思路：不要在 Jest 主进程内通过 mock process.exit 的方式模拟测试，直接使用三层进程结构实现真实场景的全链路验证，无需任何 mock 逻辑，测试结果完全等价于手动测试。

• 第一层：Jest 测试控制进程，负责启动测试、校验状态、清理资源
• 第二层：待测试的业务父进程，作为 Jest 启动的子进程运行，执行你的 spawn 逻辑
• 第三层：业务父进程启动的目标子进程

1. detached 有效性测试 #

测试逻辑：通过 Jest 启动业务父进程，等父进程成功拉起子进程后，主动结束业务父进程，再校验子进程是否仍处于存活状态。

准备辅助脚本 #

1. 测试用长驻子进程脚本child-dummy.js

// 长驻10分钟足够完成测试，结束后会被主动清理
setTimeout(() => process.exit(0), 10 * 60 * 1000);

2. 业务父进程模拟脚本parent-detached-spawner.js

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

const child = spawn(process.execPath, [path.join(__dirname, 'child-dummy.js')], {
  detached: true,
  stdio: 'ignore'
});
// 输出子进程pid给Jest控制层获取
console.log(child.pid);
// 模拟业务场景父进程主动退出
process.exit(0);

Jest 测试用例 #

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

test('父进程退出后detached子进程仍存活', async () => {
  // 启动业务父进程
  const parentProc = spawn(process.execPath, [path.join(__dirname, 'parent-detached-spawner.js')]);
  // 获取子进程pid
  const childPid = await new Promise(resolve => {
    parentProc.stdout.once('data', data => resolve(Number(data.toString().trim())));
  });
  // 等待业务父进程完全退出
  await new Promise(resolve => parentProc.on('exit', resolve));

  // 校验子进程存活：process.kill(pid, 0)仅检测进程是否存在，不会发送信号
  let childAlive = true;
  try {
    process.kill(childPid, 0);
  } catch {
    childAlive = false;
  }
  expect(childAlive).toBe(true);

  // 测试后清理，杀掉残留的测试子进程
  process.kill(childPid);
});

2. unref 有效性测试 #

测试逻辑：父进程启动带超长定时器的子进程后调用unref()，如果父进程可以在远小于定时器时长的时间内退出，即可验证unref()生效。

准备辅助脚本 #

业务父进程模拟脚本parent-unref-spawner.js

const { spawn } = require('child_process');
const startTime = Date.now();

// 子进程设置16分钟的超长定时器
const child = spawn(process.execPath, ['-e', 'setTimeout(() => {}, 999999)'], {
  stdio: 'ignore'
});
child.unref();

// 父进程无其他任务，输出启动到退出的耗时
process.on('exit', () => console.log(Date.now() - startTime));

Jest 测试用例 #

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

test('调用unref后父进程无需等待子进程即可退出', async () => {
  const parentProc = spawn(process.execPath, [path.join(__dirname, 'parent-unref-spawner.js')]);
  // 获取父进程从启动到退出的耗时
  const exitCost = await new Promise(resolve => {
    let output = '';
    parentProc.stdout.on('data', d => output += d.toString());
    parentProc.on('exit', () => resolve(Number(output.trim())));
  });
  // 正常Node进程启动退出耗时不会超过100ms，远小于子进程的999999ms定时器
  expect(exitCost).toBeLessThan(100);
});

注意事项 #

• 测试结束必须清理残留的测试子进程，避免长期占用系统资源
• 如果要验证实际业务子进程的状态，可替换process.kill(pid, 0)的检测逻辑为业务层的健康检查（比如你提到的网络通信链路发健康包），测试结果更贴合实际业务场景
• 上述逻辑兼容Windows、macOS、Linux全平台

内容的提问来源于stack exchange，提问作者Rafael Sofi-zada