Express中使用Multer多文件上传异常：仅首个文件上传成功求助

1. 核对Multer的fields配置 #

确保fields数组中image字段的name值与Postman表单字段名完全一致（大小写敏感）。示例配置：

const upload = multer({ dest: 'uploads/' }).fields([
  { name: 'coverImage', maxCount: 1 },
  { name: 'image', maxCount: 2 } // 此处name必须和Postman字段名严格匹配
]);

若Postman中字段名为images或Image，都会导致Multer无法识别。

2. 检查Postman表单设置 #

• 确认Body选项选择form-data
• coverImage和image字段类型均设为File
• 多个image文件需添加到同一个image字段下（点击字段右侧+按钮添加多文件），而非创建多个不同名称的字段。

3. 修正控制器文件获取逻辑 #

多字段上传的文件会被挂载到req.files对象，而非单文件的req.file。控制器中需通过req.files.image获取文件数组：

exports.uploadHandler = (req, res) => {
  console.log('封面图:', req.files.coverImage);
  console.log('图片组:', req.files.image); // 应为长度为2的数组
  if (!req.files.image || req.files.image.length !== 2) {
    return res.status(400).json({ msg: '请上传2张图片' });
  }
  // 后续业务逻辑
};

4. 捕获Multer上传错误 #

在路由中添加错误捕获逻辑，排查上传过程中的异常：

router.post('/upload', (req, res, next) => {
  upload(req, res, function (err) {
    if (err instanceof multer.MulterError) {
      console.log('Multer错误:', err);
      return res.status(500).json({ msg: err.message });
    } else if (err) {
      console.log('上传错误:', err);
      return res.status(500).json({ msg: '文件上传失败' });
    }
    uploadController.uploadHandler(req, res);
  });
});

查看运行日志中是否存在文件超限、路径权限等错误信息。

5. 验证存储目录权限 #

确保uploads/目录存在且具备读写权限，可在服务启动前自动创建目录：

const fs = require('fs');
const uploadDir = './uploads';
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir, { recursive: true });
}

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