Node.js从18升级到20.10后SIGTERM回调函数不再执行的问题

可能的原因 #

1. 事件循环退出逻辑变更：Node.js 20.x对事件循环的退出时机做了调整，当进程处于空闲状态（无活跃异步任务）时，收到SIGTERM后可能直接终止进程，跳过SIGTERM回调的执行。相比Node.js 18，20.x的退出流程更激进，不会等待未进入事件循环队列的回调。
2. 进程PID问题：如果Node.js进程不是Docker容器的PID 1，容器发送的SIGTERM会被PID 1的进程（通常是shell）拦截，无法传递给Node.js进程。这种情况在升级Node.js版本后可能因为启动脚本的细微变化暴露出来。
3. Docker强制终止超时：Docker默认在发送SIGTERM后等待10秒就发送SIGKILL强制杀死进程。如果回调逻辑包含异步操作，Node.js 20.x的调度延迟可能导致回调还未执行就被强制终止。

解决办法 #

1. 确保Node.js进程为容器PID 1 #

检查Docker启动命令：

• 如果使用Dockerfile的CMD，直接指定Node.js启动命令：

  CMD ["node", "app.js"]
  

• 如果通过shell脚本启动，在脚本中使用exec替换进程：

  # 正确方式：让node成为PID 1，接收信号
  exec node app.js
  

2. 强制让回调进入事件循环队列 #

使用setImmediate包裹回调逻辑，确保Node.js在退出前处理回调：

process.on('SIGTERM', () => {
  console.log('收到SIGTERM信号，开始执行清理');
  setImmediate(async () => {
    // 执行清理操作：关闭数据库连接、处理完当前请求等
    await closeDbConnection();
    await finishPendingTasks();
    process.exit(0);
  });
});

3. 保持事件循环活跃 #

如果应用在空闲时没有活跃的异步任务（如定时器、网络连接），添加一个空定时器维持事件循环：

// 每1秒触发一次空定时器，保持事件循环活跃
setInterval(() => {}, 1000);

4. 调整Docker停止超时时间 #

如果清理逻辑需要更长时间，增加Docker的停止等待时间：

• 命令行启动时：docker stop -t 30 <容器名>
• Docker Compose中配置：

  services:
    your-app:
      image: your-node-image
      stop_grace_period: 30s
  

5. 移除默认信号监听器 #

尝试移除Node.js默认的SIGTERM监听器，避免冲突：

process.removeAllListeners('SIGTERM');
process.on('SIGTERM', () => {
  // 你的清理逻辑
});

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