如何在Jest自动化测试中正确启动并停止Node服务进程？

代码存在3个直接导致服务杀不干净、Jest挂起的根因：

• 直接调用spawn('npm run start')拿到的是npm父进程的实例，npm会额外fork出真正运行服务的Node子进程。此时调用kill()只会终止npm父进程，实际占用端口的Node服务会变成孤儿进程持续运行，残留的进程句柄会直接导致Jest检测到活跃资源无法退出。
• 杀进程的逻辑写在断言流程中，一旦服务启动阶段抛错、后续断言失败，杀进程的代码根本不会执行，服务进程会永久留驻。
• 服务启动轮询逻辑没有加延迟，会空跑占满事件循环；没有处理子进程stdio流，缓冲区写满后会阻塞进程退出；杀进程后没有等待进程真正终止就继续执行，资源未完全释放时Jest不会正常退出。

import fetch from 'node-fetch';
import { spawn } from 'child_process';

jest.setTimeout(100000);

let serverProcess;

// 兜底清理逻辑：无论测试成功/失败都执行，避免残留进程
afterEach(async () => {
  if (serverProcess && !serverProcess.killed) {
    // 跨平台杀掉整个进程树，避免漏杀npm派生的Node服务子进程
    if (process.platform === 'win32') {
      spawn('taskkill', ['/pid', serverProcess.pid, '/f', '/t']);
    } else {
      process.kill(-serverProcess.pid, 'SIGKILL');
    }
    // 等待进程完全退出、所有句柄释放后再继续
    await new Promise(resolve => serverProcess.on('close', resolve));
  }
});

test('starting the root-config opens a webserver on port 9000', async () => {
  // 启动服务时创建独立进程组，忽略stdio避免流阻塞
  serverProcess = spawn('npm', ['run', 'start'], {
    detached: true,
    stdio: 'ignore'
  });

  // 带间隔、最大重试次数的健康检查，避免死循环
  const maxRetries = 30;
  const retryInterval = 1000;
  let response;
  for (let i = 0; i < maxRetries; i++) {
    try {
      response = await fetch("http://localhost:9000");
      break;
    } catch (e) {
      await new Promise(resolve => setTimeout(resolve, retryInterval));
    }
  }

  if (!response) throw new Error('Server failed to start within 30 seconds');
  expect(response.status).toBe(200);
});

• 清理逻辑放到Jest的afterEach钩子中，覆盖测试抛错、断言失败等所有异常场景，保证进程一定会被清理。
• 启动服务时加detached: true配置创建独立进程组，终止进程时针对整个进程组/进程树做强制 kill，不会漏掉npm启动的实际服务子进程，同时兼容Windows和类Unix系统。
• 轮询逻辑增加1秒重试间隔和30次最大重试限制，避免无意义空转占满CPU，也避免服务启动失败时无限循环卡死。
• 配置stdio: 'ignore'丢弃子进程输出，避免日志填满流缓冲区导致进程阻塞，同时消除stdio管道带来的句柄残留。
• 杀进程后等待进程的close事件触发，确认端口、进程句柄全部释放后再结束测试流程，保证Jest能正常退出。

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