Windows下Node.js被process.kill终止时如何清理临时文件？

问题描述 #

• 编写的Node.js脚本会创建临时文件，原本设计退出时自动删除：
  • 脚本正常退出（返回码0）时，临时文件可被删除；
  • 手动按Control+C终止脚本时，临时文件可被删除；
  • 仅在Windows环境（Windows 11，Git Bash/PowerShell运行）下，当脚本被其他Node.js脚本通过process.kill(pid)或subprocess.kill()终止时，临时文件无法自动删除；Linux（WSL2 Ubuntu）下无此问题。
• 该脚本用于lint-staged，当某个任务失败时，并发运行的其他任务会被process.kill强制终止，无法控制这一行为。

原因分析 #

Windows原生不支持Unix信号机制，Node.js对process.kill()和subprocess.kill()做了信号模拟，但默认情况下，通过这些方法发送的终止信号（比如默认的SIGTERM）在Windows上不会触发Node.js进程的信号事件监听，导致清理临时文件的代码无法执行。

解决方法 #

针对Windows的信号模拟特性，需要调整监听的信号类型，并补充兜底处理：

1. 添加SIGBREAK信号监听：Windows下Node.js会将process.kill()发送的SIGTERM映射为SIGBREAK，必须监听该信号才能捕获这类终止操作；
2. 提取统一的cleanup逻辑：避免重复代码，同时确保操作幂等（只执行一次删除）；
3. 用beforeExit事件兜底：在进程即将退出且无异步任务pending时触发，作为最后保障；
4. 优化临时文件命名：使用系统临时目录+进程ID命名，避免并发任务的文件冲突，降低遗漏删除的影响。

修改后的代码示例 #

import fs from "fs";
import os from "os";
import path from "path";

// 使用系统临时目录+进程ID生成唯一临时文件名，避免并发冲突
const tmpFile = path.join(os.tmpdir(), `foo-${process.pid}.txt`);
fs.writeFileSync(tmpFile, "randomContent");

let didCleanup = false;

// 统一的清理逻辑，包裹try/catch避免删除失败导致进程无法退出
const cleanup = () => {
  if (!didCleanup) {
    didCleanup = true;
    try {
      fs.unlinkSync(tmpFile);
    } catch (err) {
      // 忽略删除失败（比如文件已被手动移除），不影响进程退出
    }
  }
};

// 监听所有可能触发退出的信号，新增Windows特有的SIGBREAK
for (const signal of ["exit", "SIGHUP", "SIGINT", "SIGTERM", "SIGBREAK"] as const) {
  process.on(signal, () => {
    cleanup();
    if (signal !== "exit") {
      // 按信号类型设置对应退出码
      const exitCodes: Record<string, number> = {
        SIGHUP: 129,
        SIGINT: 130,
        SIGTERM: 143,
        SIGBREAK: 131
      };
      process.exit(exitCodes[signal] || 1);
    }
  });
}

// 添加beforeExit作为兜底，覆盖信号未被捕获的场景
process.on('beforeExit', cleanup);

// 其他与临时文件交互的任务...

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