Node.js如何无竞态条件地根据文件是否存在写入不同内容

你的核心问题在于：原有的“检查文件存在→写入/追加”逻辑存在竞态窗口（检查后到写入前，文件可能被其他进程创建/修改）；而你尝试的wx模式只处理了创建分支，未正确处理文件已存在时的追加逻辑，导致竞态问题残留。

正确实现思路 #

利用文件系统的原子操作特性：

• 用wx模式尝试打开文件：该模式原子性地创建新文件，若文件已存在则直接失败（错误码EEXIST），无中间竞态窗口。
• 捕获EEXIST错误时，直接用a模式打开文件追加内容：此时可100%确定文件已存在，无需再次检查，避免竞态。

TypeScript 实现代码 #

import { open, FileHandle } from 'fs/promises';
import { constants } from 'fs';

export async function writeOrAppend(
  file: string,
  appendText: string,
  initText: string
) {
  let fileHandle: FileHandle | undefined;
  try {
    // 原子性尝试创建新文件
    fileHandle = await open(file, 'wx');
    // 进入此分支说明文件刚被创建，写入初始化内容
    await fileHandle.writeFile(initText);
  } catch (err: any) {
    // 仅处理文件已存在的错误，其他错误抛出
    if (err.code !== 'EEXIST') {
      throw err;
    }
    // 文件已存在，用追加模式打开
    fileHandle = await open(file, 'a');
    await fileHandle.writeFile(appendText);
  } finally {
    // 确保文件句柄关闭
    await fileHandle?.close();
  }
}

// 使用示例
// 首次调用：写入介绍+分隔线+首次事件
writeOrAppend('./log.txt', '\n新事件内容', '这是介绍文本\n---\n首次事件内容');
// 后续调用：仅追加单行事件
writeOrAppend('./log.txt', '\n新事件内容', '');

关键细节说明 #

• wx模式的原子性：操作系统保证wx打开操作要么成功创建文件，要么因为文件存在失败，不会出现“检查时不存在，准备写入时已存在”的竞态。
• 错误过滤：只处理EEXIST错误，其他错误（如权限不足、路径无效）直接抛出，避免隐藏问题。
• 资源清理：finally块确保无论成功失败，文件句柄都会被关闭，防止资源泄漏。

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