如何让Node.js脚本即使事件循环被占用也能超时终止？

你遇到的问题很典型：Node.js是单线程事件循环模型，当同步代码（比如你示例里的while(true)）一直占用主线程时，事件循环根本没机会处理定时器回调，所以setTimeout永远不会触发。要解决这个问题，你需要把可能阻塞的任务（比如容易卡住的Selenium测试）和超时监控逻辑分开到不同的执行单元里，下面是两种可靠的方案：

方案1：使用Worker Threads（推荐） #

Worker Threads是Node.js内置的多线程模块，可以把可能卡住的测试代码放到独立的Worker线程中，主线程专门负责超时监控——这样主线程的事件循环不会被阻塞，定时器能正常触发。

示例代码：

const { Worker } = require('worker_threads');

// 创建Worker线程运行你的Selenium测试
const testWorker = new Worker(`
  // 这里替换成你的实际Selenium测试代码
  const { Builder } = require('selenium-webdriver');
  async function runTest() {
    const driver = await new Builder().forBrowser('chrome').build();
    try {
      await driver.get('https://example.com');
      // 模拟可能卡住的操作（比如等待一个永远不会出现的元素）
      await driver.wait(() => false, 100000);
    } finally {
      await driver.quit();
    }
  }
  runTest();
`, { eval: true });

// 设置超时时间（比如10秒）
const TIMEOUT = 10000;
const timeoutTimer = setTimeout(() => {
  console.log('测试超时，强制终止进程');
  testWorker.terminate(); // 终止Worker线程
  process.exit(1); // 退出主线程，标记测试失败
}, TIMEOUT);

// 如果测试正常完成，清除超时定时器
testWorker.on('exit', (exitCode) => {
  clearTimeout(timeoutTimer);
  console.log(`测试完成，退出码：${exitCode}`);
  process.exit(exitCode);
});

// 捕获Worker的错误输出
testWorker.on('error', (err) => {
  console.error('测试线程出错：', err);
  clearTimeout(timeoutTimer);
  process.exit(1);
});

方案2：使用子进程（Child Process） #

如果你的Node.js版本较低（不支持Worker Threads，需要v10.5.0以上），可以用Child Process把测试代码放到独立的子进程中，主线程同样负责超时监控。

示例代码：

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

// 假设你的Selenium测试代码写在test.js文件中
const testProcess = spawn('node', [path.join(__dirname, 'test.js')]);

const TIMEOUT = 10000;
const timeoutTimer = setTimeout(() => {
  console.log('测试超时，强制终止');
  testProcess.kill('SIGTERM'); // 杀掉子进程
  process.exit(1);
}, TIMEOUT);

// 子进程正常退出时清理定时器
testProcess.on('exit', (exitCode) => {
  clearTimeout(timeoutTimer);
  console.log(`测试进程退出，退出码：${exitCode}`);
  process.exit(exitCode);
});

// 同步子进程的输出到主线程
testProcess.stdout.on('data', (data) => {
  console.log(`测试输出：${data.toString().trim()}`);
});

testProcess.stderr.on('data', (data) => {
  console.error(`测试错误：${data.toString().trim()}`);
});

为什么原代码无法工作？ #

简单来说，Node.js的事件循环必须等当前同步代码执行完，才会进入下一个阶段处理定时器、I/O等异步任务。你的while(true)是无限循环的同步代码，会永远霸占主线程，事件循环根本没机会去触发setTimeout的回调函数，自然无法执行退出逻辑。

这两种方案的核心都是把可能阻塞的任务从主线程剥离，让主线程能正常处理定时器，从而确保超时后无论子任务状态如何，都能强制终止整个进程。

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