Multer文件上传数量异常求助：如何在上传前校验文件数量

嘿，我完全懂你碰到的麻烦——Multer默认是逐个处理上传文件的，所以如果你的配置导致中间件被多次触发（比如误用了single()处理多文件上传），就会出现每次req.files里只有一个文件的情况。要在文件上传前（也就是还没开始写入磁盘前）校验总数量，有几个实用的方案：

1. 先修正Multer的基础配置（最省心的方案） #

如果你是把多个文件放在同一个表单字段里（比如前端用name="files"的文件输入框并开启了多选），别用upload.single()或者多次调用single()，改用upload.array('files', maxCount)：

const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

app.post('/upload', upload.array('files', 3), (req, res) => {
  // 这里req.files就是包含所有上传文件的数组，length直接对应总数量
  console.log(req.files.length); // 上传3个文件的话这里会输出3
});

这种方式下，Multer会自动在处理文件前校验数量——如果上传超过maxCount（这里设为3），会直接抛出LIMIT_UNEXPECTED_FILE错误，你可以通过错误处理中间件捕获并返回提示：

app.use((err, req, res, next) => {
  if (err instanceof multer.MulterError && err.code === 'LIMIT_UNEXPECTED_FILE') {
    return res.status(400).send('上传文件数量超过限制！');
  }
  next(err);
});

2. 自定义前置中间件，提前解析文件数量（适合复杂场景） #

如果你的上传场景比较特殊（比如文件分散在不同表单字段，或者需要更灵活的校验逻辑），可以用Multer底层依赖的busboy库，先手动解析请求的multipart头部，统计文件数量，校验通过后再交给Multer处理：

const busboy = require('busboy');
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

function checkFileCount(maxCount) {
  return (req, res, next) => {
    const contentType = req.headers['content-type'];
    if (!contentType || !contentType.includes('multipart/form-data')) {
      return next(); // 不是表单上传，直接跳过
    }

    const bb = busboy({ headers: req.headers });
    let fileCount = 0;
    let isValid = true;

    bb.on('file', () => {
      fileCount++;
      if (fileCount > maxCount) {
        isValid = false;
        bb.destroy(); // 停止解析请求体
        return res.status(400).send(`最多只能上传${maxCount}个文件！`);
      }
    });

    bb.on('finish', () => {
      if (isValid) {
        // 校验通过，重新让Multer处理请求
        req.unpipe(bb);
        next();
      }
    });

    req.pipe(bb);
  };
}

// 使用方式：先校验数量，再处理上传
app.post('/upload', checkFileCount(3), upload.any(), (req, res) => {
  console.log(req.files.length);
});

这个方法能在真正写入文件到磁盘前就完成数量校验，避免不必要的磁盘IO。

3. 前端先做一层辅助校验（提升用户体验） #

虽然后端校验是必须的，但可以在前端先做拦截，比如用JavaScript获取文件输入框的files属性判断长度：

const fileInput = document.querySelector('input[type="file"][multiple]');
fileInput.addEventListener('change', (e) => {
  const files = e.target.files;
  if (files.length > 3) {
    alert('最多只能选择3个文件！');
    e.target.value = ''; // 清空已选文件
  }
});

注意：前端校验只能提升体验，绝对不能替代后端校验——毕竟前端逻辑很容易被绕过。

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