使用multer时req.files未定义，切换到authRouter后文件上传失败

问题描述 #

• 直接使用router.post接口处理文件上传正常，但切换到authRouter后，req.files变为undefined
• 前端Axios请求返回500错误（ERR_BAD_RESPONSE），服务器控制台报错TypeError: images is not iterable

可能原因及解决方案 #

1. 字段名不匹配 #

前端FormData中使用了images[]作为字段名，但multer的upload.array()方法不需要加[]，multer会自动解析同名的多个文件。

修改代码：

• 客户端代码：

const formData = new FormData();
this.selectedImages.forEach(image => {
     formData.append('images', image.file); // 移除[]
});

axios.post(`/a/republica/store/pictures/${this.$route.params.id_repu}`, formData)
.then(() => {
      router.push('/');         
}).catch((error) =>{
   console.error('Erro na solicitação HTTP:', error);
});

• 路由文件：

// 将upload.array('images[]')改为upload.array('images')
authRouter.post('/republica/store/pictures/:repu_id', upload.array('images'), republicaController.adicionaFotosRepublica);

2. AuthRouter中间件拦截Multipart请求 #

如果authRouter挂载了身份验证中间件，需要确保中间件不会提前消耗请求体，或者允许multipart/form-data类型的请求通过。

示例修改auth中间件：

authRouter.use((req, res, next) => {
  if (req.is('multipart/form-data')) {
    return next(); // 跳过JSON解析，交给multer处理
  }
  // 原有的JSON解析和身份验证逻辑
  express.json()(req, res, next);
});

3. 上传目录不存在 #

Multer不会自动创建上传目录，若./uploads目录不存在，会导致文件保存失败，间接引发req.files异常。

修改multer配置，自动创建目录：

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

const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    const destination = "./uploads";
    // 递归创建目录
    if (!fs.existsSync(destination)) {
        fs.mkdirSync(destination, { recursive: true });
    }
    cb(null, destination);
  },
  filename: function (req, file, cb) {
    const uniqueFilename = Date.now() + path.extname(file.originalname);
    console.log("Nome do arquivo gerado:", uniqueFilename);
    cb(null, uniqueFilename);
  },
});

const upload = multer({ storage });

module.exports = upload;

4. 控制器增加异常防护 #

在控制器中添加对req.files的校验，避免因文件未解析导致的迭代错误：

RepublicaController.adicionaFotosRepublica = async (req, res) => {
  try {
      const images = req.files;
      // 校验文件是否存在
      if (!images || images.length === 0) {
          return res.status(400).json({ error: 'Nenhuma imagem foi enviada' });
      }      
      const republica = await Republica.findOne({_id: req.params.repu_id});
      if (!republica) {
          return res.status(404).json({ error: 'República não encontrada' });
      }
         
      for (const image of images) {
        await saveFile(image.filename);
        republica.pictures.push(image.filename);
        console.log('Images:', image.filename);
     }

     const response = await republica.save();
     return res.status(200).json({status: 'sucesso'})

  } catch (error) {
      console.error(error);
      res.status(500).json({ error: error.message })
  }
}

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