Mac下NodeJS应用SIGINT处理器按Ctrl+C未触发问题

这问题我之前踩过坑！核心原因是Node.js的事件循环被你的同步大循环完全阻塞了，导致SIGINT信号根本没机会被处理。

为什么会出现这种情况？ #

Node.js的信号处理（比如SIGINT）是在事件循环的空闲阶段执行的。当你有一个持续数秒的同步大循环时，主线程会一直卡在这个循环里，事件循环完全停转——哪怕你按下Ctrl+C发送了SIGINT信号，Node.js也得等这个同步循环跑完，才会去执行你的信号回调。这时候循环已经结束，后面的console.log('Exited without interruption')直接执行，进程自然就退出了，你的Interrupted日志当然打不出来。

而当你移除process.on()监听时，Node.js会使用默认的SIGINT处理逻辑：直接终止进程，不需要等待当前同步代码执行完，所以按Ctrl+C进程会立刻退出，不会输出后面的日志。

有效解决方案 #

要解决这个问题，核心就是别让主线程被同步代码长时间阻塞，给事件循环留处理信号的机会，这里有两种实用的方法：

方法1：把同步大循环拆成异步迭代

把你的大循环拆分成小块，每执行一部分就主动让出事件循环，让Node.js有机会处理信号：

process.on('SIGINT', function() {
  console.log('Interrupted');
  process.exit();
});

// 拆分同步循环为异步执行
async function runBigLoop() {
  const totalIterations = 1000000000; // 你的循环总次数
  const chunkSize = 1000000; // 每执行100万次就让出事件循环

  for (let i = 0; i < totalIterations; i++) {
    // 这里写你的循环逻辑
    // ...

    // 每执行完一个chunk，让出事件循环
    if (i % chunkSize === 0) {
      await new Promise(resolve => setImmediate(resolve));
    }
  }
  console.log('Exited without interruption');
}

runBigLoop();

这样每执行100万次循环，就会让事件循环处理其他任务（包括SIGINT信号），按下Ctrl+C时，信号回调会立刻被触发，进程直接退出。

方法2：用Worker Threads把计算任务移到子线程

如果你的循环是计算密集型、必须同步执行的，推荐用Node.js的worker_threads模块把计算放到子线程里，主线程只负责处理信号和控制流程：

1. 主线程代码：

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

process.on('SIGINT', function() {
  console.log('Interrupted');
  worker.terminate(); // 终止子线程
  process.exit();
});

// 创建子线程执行大循环
const worker = new Worker('./big-loop-worker.js');

// 子线程正常结束时触发
worker.on('exit', () => {
  console.log('Exited without interruption');
});

2. 子线程文件big-loop-worker.js：

// 这里放你的同步大循环
for (let i = 0; i < 1000000000; i++) {
  // 你的循环逻辑
  // ...
}

process.exit();

这种方式下主线程不会被阻塞，能及时响应SIGINT信号，按下Ctrl+C会立刻终止子线程并退出进程。

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