Node.js调用process.kill触发SIGTERM时处理函数未执行且退出码为1如何调试

调试定位方法 #

• 首先在代码最顶部添加全局事件监听，捕获未处理的异常和进程事件：

process.on('uncaughtException', err => console.error('未捕获异常：', err));
process.on('exit', code => console.log('进程退出，退出码：', code));
// 兜底监听所有常见信号事件
['SIGTERM', 'SIGINT', 'SIGBREAK'].forEach(sig => {
  process.on(sig, () => console.log(`收到信号：${sig}`));
});

添加后重新运行代码，可以确认进程退出时没有触发SIGTERM回调，直接以退出码1终止。

• 其次验证运行环境兼容性：Node.js的信号监听实现依赖操作系统的POSIX信号规范，Windows平台仅支持有限的信号类型，SIGTERM在Windows下无法被捕获，调用process.kill(process.pid, 'SIGTERM')会直接强制结束进程，不会等待事件队列中的回调执行。

解决与验证方案 #

如果是在Windows环境下测试进程优雅退出逻辑，可以替换为支持的信号类型，比如SIGINT：

process.on("SIGINT", () => {
  console.log("Handler started");
  server.close(() => {
    console.log("Process terminated");
    process.exit(0);
  });
});

注释掉原有for循环中的process.kill代码，启动服务后按下Ctrl + C即可触发回调正常执行。如果在Linux或macOS环境下运行你的原始代码，SIGTERM回调会正常触发，不会出现提前退出的问题。

额外注意事项 #

你写的for循环是同步执行逻辑，信号触发后的回调会被推入事件队列，要等同步代码全部执行完成后才会运行，如果你要测试同步执行阶段触发信号的逻辑，需要确认当前运行环境支持对应信号的监听。

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