Windows下如何通过代码正确终止Node.js子进程（NX模块场景）

核心问题 #

你遇到的问题根源有两个：

1. shell: true导致PID指向shell进程而非目标服务器进程：启用shell: true时，spawn启动的是Windows的cmd.exe，而非你的服务器命令。你后续杀死的是cmd.exe的PID，但它的子进程（实际服务器）会脱离控制继续运行。
2. taskkill调用未处理异步逻辑：spawn是异步操作，直接调用后未等待执行完成，NX进程可能在kill操作生效前就继续执行，导致进程未被终止。

修复步骤 #

1. 优先禁用shell: true（推荐） #

如果你的服务器命令不需要shell解析（无管道、通配符等需求），直接关闭shell: true，此时serverProcess.pid就是实际服务器进程的PID，kill操作可直接生效：

function startServer(cwd: string, command: string): () => Promise<void> {
    // 拆分命令为命令名和参数（例如"npm run serve"拆分为["npm", "run", "serve"]）
    const [cmd, ...args] = command.split(' ');
    const serverProcess = spawn(cmd, args, {
        cwd,
        shell: false,
        detached: process.platform !== 'win32',
        stdio: 'inherit'
    });

    return async () => {
        if (process.platform === 'win32') {
            // 先尝试优雅终止，超时后强制杀死
            serverProcess.kill('SIGINT');
            await new Promise(resolve => {
                serverProcess.on('exit', resolve);
                setTimeout(resolve, 3000); // 3秒超时阈值
            });
            // 若进程仍存活，用taskkill强制终止进程树
            if (!serverProcess.killed) {
                await new Promise(resolve => {
                    spawn('taskkill', ['/pid', serverProcess.pid.toString(), '/f', '/t'])
                        .on('exit', resolve);
                });
            }
        } else {
            process.kill(-serverProcess.pid, 'SIGINT');
        }
    }
}

2. 必须使用shell: true时的处理方案 #

如果依赖shell解析命令，需确保杀死整个进程树。此时serverProcess.pid是cmd.exe的PID，用taskkill /f /t可终止它和所有子进程，但要等待操作完成：

function startServer(cwd: string, command: string): () => Promise<void> {
    const serverProcess = spawn(command, {
        cwd,
        shell: true,
        detached: process.platform !== 'win32',
        stdio: 'inherit'
    });

    return async () => {
        if (process.platform === 'win32') {
            await new Promise(resolve => {
                // /f强制终止，/t终止所有子进程
                spawn('taskkill', ['/pid', serverProcess.pid.toString(), '/f', '/t'])
                    .on('exit', resolve);
            });
        } else {
            process.kill(-serverProcess.pid, 'SIGINT');
        }
    }
}

3. 调整调用逻辑，等待kill操作完成 #

由于kill函数改为异步，需在测试完成后等待kill操作结束再返回结果：

const killEmulators = startServer('<expected directory>', '<emulator command>');
const killDevServer = startServer('<expected server directory>', '<dev server command>');
const result = runTestsThatNeedTheseServers();
// 等待两个kill操作执行完毕
await killDevServer();
await killEmulators();
return result;

额外注意事项 #

• 避免同时调用多种kill方法（如同时用serverProcess.kill()和taskkill），防止逻辑冲突。
• 可监听子进程exit事件，确认进程是否真的终止：

  serverProcess.on('exit', (code, signal) => {
      console.log(`服务器进程退出，代码：${code}，信号：${signal}`);
  });
  

• 若使用tree-kill模块，需传入正确PID并等待异步操作完成（模块支持回调或Promise）。

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