Node.js异步mkdir报EEXIST错误但目录实际不存在问题求助

这种情况我之前在Linux环境下也碰到过，看似矛盾的报错通常是由文件系统的特殊情况或者代码逻辑的小疏漏导致的，咱们一步步来排查和解决：

可能的核心原因 #

1. 路径中存在同名文件或符号链接：如果目标路径下已经有一个文件（不是目录）和你要创建的目录同名，mkdir会直接抛出EEXIST错误；另外如果路径中包含符号链接指向已存在的目录，也会触发这个报错。
2. 缺少递归创建参数：你的代码是逐个创建目录，但没有使用recursive: true参数，若父目录的创建过程有隐性问题（比如符号链接冲突），创建子目录时就会报错。
3. 文件系统元数据缓存：Linux的文件系统缓存偶尔会导致Node.js读取到过时的目录状态。

修复代码：更可靠的目录创建逻辑 #

首先优化你的目录创建函数，加入recursive: true参数（Node.js v10+支持），这个参数不仅能递归创建整个目录树，还会自动忽略目录已存在的情况（不会抛出EEXIST），同时我们只忽略明确的EEXIST错误，避免掩盖其他问题（比如权限不足）：

const fsPromises = require('fs').promises;
const containerWorkDirectory = `/home/msh/Documents/arraba-api/app/build/plugin/images/images`;

const createDirectoryIfNotExists = async (dir, permission = true) => {
  try {
    await fsPromises.mkdir(dir, {
      mode: permission ? 0o775 : undefined,
      recursive: true // 关键：递归创建目录树，自动处理已存在的情况
    });
    console.log(`目录 ${dir} 已就绪（创建成功或已存在）`);
  } catch (error) {
    // 只忽略EEXIST错误，其他错误（如权限不足）需要抛出并处理
    if (error.code !== 'EEXIST') {
      console.error(`创建目录 ${dir} 失败:`, error.message);
      throw error;
    }
    console.warn(`目录 ${dir} 已存在，跳过创建`);
  }
};

const userDirectoryTreeCreation = async (userId) => {
  const userProfileImagesDirectory = `${containerWorkDirectory}/${userId}/profile`;
  const userCarImagesDirectory = `${containerWorkDirectory}/${userId}/cars`;
  
  // 有了recursive: true，直接创建最底层目录即可，父目录会自动生成
  await createDirectoryIfNotExists(userProfileImagesDirectory, true);
  await createDirectoryIfNotExists(userCarImagesDirectory, true);
};

// 别忘了捕获全局错误
userDirectoryTreeCreation(1).catch(err => console.error('目录树创建失败:', err));

排查Linux环境的特殊情况 #

如果优化代码后仍然报错，按以下步骤排查：

1. 检查路径中的文件/符号链接：
   运行命令查看目标路径的内容，确认是否有同名文件或符号链接：

   ls -la /home/msh/Documents/arraba-api/app/build/plugin/images/images/5/
   

   • 如果发现profile或cars是文件，删除该文件或者修改目录名即可；
   • 如果是符号链接，用readlink查看链接指向：

     readlink /home/msh/Documents/arraba-api/app/build/plugin/images/images/5/profile
     

     确认是否和你要创建的目录路径冲突。

2. 刷新文件系统缓存：
   执行sync命令刷新系统缓存，避免读取到过时的目录状态：

   sync
   

3. 验证目录权限：
   确保运行Node.js的用户对父目录有读写权限：

   ls -ld /home/msh/Documents/arraba-api/app/build/plugin/images/images/
   

   如果权限不足，修改目录权限：

   chmod -R 775 /home/msh/Documents/arraba-api/app/build/plugin/images/images/
   

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