Node.js使用FileSystem删除文件失败：EBUSY错误排查求助

我来帮你一步步排查这个EBUSY（资源被占用或锁定）的问题，结合你的代码来看，主要有几个核心问题和对应的解决办法：

1. 路径拼接错误是隐形坑 #

你的重命名代码里用了硬编码的\作为路径分隔符，而且路径截取逻辑有问题，这会导致实际操作的文件路径和你预期的不一致，甚至可能出现文件实际位置与删除路径不匹配的情况，进而引发异常。

修复重命名的路径处理 #

用Node.js内置的path模块来处理路径，它会自动适配操作系统的分隔符，避免手动拼接出错：

await form.parse(fileData, (err: Error, fields: any, res: any) => {
  if (err) {
    callback(err, null);
    return;
  }
  const fileInfo = res.file[0];
  // 用path模块正确拆分文件目录和文件名
  const fileDir = path.dirname(fileInfo.path);
  const tempFileName = path.basename(fileInfo.path);
  const originalFileName = fileInfo.originalFilename;
  // 用path.join安全拼接目标路径
  const originalFilePath = path.join(fileDir, originalFileName);

  fs.rename(fileInfo.path, originalFilePath, function (err: any) {
    if (err) {
      callback(err, null);
    } else {
      // 这里要传null作为错误参数，之前的写法有误
      callback(null, JSON.stringify({'path': originalFilePath}));
    }
  });
});

2. 异步删除的逻辑漏洞 #

你的deleteTempFiles方法里，用了异步的fs.unlink但直接在循环后就调用resolve()，这会导致删除操作还没执行完就标记任务完成，而且错误处理也不完整（比如单个文件删除失败时直接reject，但其他文件的删除操作还在继续）。

修复异步删除的逻辑 #

用Promise.all来等待所有删除操作完成，确保每个文件的删除状态都被正确处理：

deleteTempFiles(tempFolderPath: string) {
  return new Promise((resolve, reject) => {
    fs.readdir(tempFolderPath, (err, files) => {
      if (err) {
        return reject(err);
      }
      // 确保文件夹路径末尾有正确的分隔符，避免拼接成类似"folderfile.txt"的错误路径
      const normalizedFolderPath = tempFolderPath.endsWith(path.sep) 
        ? tempFolderPath 
        : tempFolderPath + path.sep;

      // 将每个删除操作包装成Promise
      const deleteTasks = files.map(file => {
        const fullFilePath = normalizedFolderPath + file;
        return new Promise((taskResolve, taskReject) => {
          // 先检查文件是否可访问（存在且有删除权限）
          fs.access(fullFilePath, fs.constants.F_OK | fs.constants.W_OK, (accessErr) => {
            if (accessErr) {
              return taskReject(new Error(`无法访问文件 ${fullFilePath}: ${accessErr.message}`));
            }
            fs.unlink(fullFilePath, (unlinkErr) => {
              unlinkErr ? taskReject(unlinkErr) : taskResolve();
            });
          });
        });
      });

      // 等待所有删除任务完成
      Promise.all(deleteTasks)
        .then(() => resolve())
        .catch(deleteErr => reject(deleteErr));
    });
  }).catch(e => {
    return Promise.reject(e.message);
  });
}

3. EBUSY报错的核心排查点 #

如果修复上述问题后仍然报错，那大概率是文件被占用：

• 确认调用时机：确保deleteTempFiles是在文件重命名完成后才调用的（必须等fs.rename的callback执行完毕），不能在异步操作未完成时就触发删除。
• 外部进程占用：检查是否有其他进程在使用该文件，比如文件管理器打开了目标文件夹、杀毒软件正在扫描文件，或者其他服务正在读取该文件。
• 同步删除测试：可以临时用fs.unlinksync替代fs.unlink测试，如果同步删除也报错，基本可以确定是外部进程占用或路径问题。

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