Node.js+Express+Multer动态创建文件夹报错问题排查

我使用Node.js结合Express和Multer搭建服务器，通过multipart/form-data接收一个identifier参数和12张图片，计划将图片存储在以identifier命名的动态创建文件夹中。服务器已有基础目录：

• /Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/received/
• /Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/only_segmented/

收到请求时，需要基于传入的identifier（例如7ee1a048-f81f-4a）创建子目录/Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/received/7ee1a048-f81f-4a/，但用Postman测试时触发错误。

控制器代码 #

const express = require('express');
const multer = require('multer');
const fs = require('fs');
const path = require('path');

const router = express.Router();
const { uploadCollection } = require('../controllers/controller_upload_collection');

const destinationPath = path.join(__dirname, '..', 'cerambyx_data', 'received');

// Configuración de Multer para subida de archivos
const storage = multer.diskStorage({
  destination: async function (req, file, cb) {
      const identifier = req.body.identifier;
      const receivedDir = path.join(destinationPath, identifier); // Ruta completa

      try {
          // Verificar si la carpeta de destino existe
          const destinationStats = await fs.promises.stat(destinationPath);

          // Si no existe, intentar crearla
          if (!destinationStats.isDirectory()) {
              await fs.promises.mkdir(destinationPath, { recursive: true });
              console.log('Carpeta base de destino creada:', destinationPath);
          }

          // Verificar si la subcarpeta específica existe
          const receivedStats = await fs.promises.stat(receivedDir);

          // Si no existe, intentar crearla
          if (!receivedStats.isDirectory()) {
              await fs.promises.mkdir(receivedDir, { recursive: true });
              console.log('Subcarpeta específica de destino creada:', receivedDir);
          }

          // Llamar al callback de Multer con la ruta completa
          cb(null, receivedDir);
      } catch (error) {
          console.error('Error al verificar o crear la carpeta de destino:', error);
          cb(error); // Llamar al callback con el error
      }
  },
  filename: function (req, file, cb) {
      cb(null, file.originalname);
  }
});


  
const upload = multer({ 
    storage: storage,
    limits: { fileSize: 30 * 1024 * 1024 }, // 30MB por archivo
    fileFilter: function (req, file, cb) {
        // Aquí puedes agregar lógica de filtrado si es necesario
        cb(null, true);
    }
});

// Ruta para subir fotos
router.post('/', upload.array('photos', 12), uploadCollection);

module.exports = { uploadCollectionRouter: router };

错误信息 #

Error al verificar o crear la carpeta de destino: [Error: ENOENT: no such file or directory, stat '/Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/received/7ee1a048-f81f-4a'] {
  errno: -2,
  code: 'ENOENT',
  syscall: 'stat',
  path: '/Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/received/7ee1a048-f81f-4a'
}

问题原因与修复方案 #

核心问题 #

1. fs.promises.stat的逻辑缺陷：当目标目录不存在时，stat会直接抛出ENOENT错误，无法走到后续的“判断是否为目录再创建”逻辑，直接进入catch块终止流程。
2. 相对路径可能计算错误：path.join(__dirname, '..', 'cerambyx_data', 'received')的实际路径可能与预期不符，需确认控制器文件的位置是否影响相对路径解析。

修复代码 #

利用fs.promises.mkdir的recursive: true特性，无需提前判断目录是否存在——该参数会自动创建所有缺失的父目录，且目录已存在时不会报错。同时添加参数校验，避免因identifier缺失导致异常：

const express = require('express');
const multer = require('multer');
const fs = require('fs');
const path = require('path');

const router = express.Router();
const { uploadCollection } = require('../controllers/controller_upload_collection');

// 改用绝对路径避免相对路径解析错误
const destinationPath = '/Users/vmartin/SourceCode/CerambyxApi/httpdocs/cerambyx_data/received';

// Multer存储配置
const storage = multer.diskStorage({
  destination: async function (req, file, cb) {
      const identifier = req.body.identifier;
      // 校验identifier参数是否存在
      if (!identifier) {
          return cb(new Error('identifier参数缺失'));
      }
      const receivedDir = path.join(destinationPath, identifier);

      try {
          // 自动创建目录（含父目录），已存在则无操作
          await fs.promises.mkdir(receivedDir, { recursive: true });
          console.log('目录已准备就绪:', receivedDir);
          cb(null, receivedDir);
      } catch (error) {
          console.error('创建目录失败:', error);
          cb(error);
      }
  },
  filename: function (req, file, cb) {
      cb(null, file.originalname);
  }
});

const upload = multer({ 
    storage: storage,
    limits: { fileSize: 30 * 1024 * 1024 }, // 单文件最大30MB
    fileFilter: function (req, file, cb) {
        // 可选：添加图片格式过滤
        const allowedTypes = ['image/jpeg', 'image/png', 'image/jpg'];
        if (allowedTypes.includes(file.mimetype)) {
            cb(null, true);
        } else {
            cb(new Error('仅支持JPG/PNG格式图片'));
        }
    }
});

router.post('/', upload.array('photos', 12), uploadCollection);

module.exports = { uploadCollectionRouter: router };

额外检查项 #

• 确认Postman中identifier是作为form-data的字段传入，而非URL参数或JSON格式请求体。
• 检查服务器进程对目标根目录是否有读写权限，避免权限不足导致创建失败。
• 可在代码中打印destinationPath和receivedDir的实际值，验证路径是否正确。

内容的提问来源于stack exchange，提问作者Víctor Martín