如何让Multer在请求体无文件时优雅失败并捕获异常？

一、捕获Multer的LIMIT_UNEXPECTED_FILE异常 #

你遇到的RangeError是因为直接把Multer的错误码当成HTTP状态码返回了，正确做法是通过自定义错误处理中间件捕获Multer抛出的错误，再返回友好响应：

1. 先配置Multer（指定允许的文件字段或限制）

const multer = require('multer');
const upload = multer({
  limits: {
    fileSize: 1024 * 1024 // 示例：限制单文件最大1MB
  }
});

2. 添加全局错误处理中间件（需放在所有路由定义之后）

app.use((err, req, res, next) => {
  if (err instanceof multer.MulterError) {
    // 针对性处理Multer错误
    if (err.code === 'LIMIT_UNEXPECTED_FILE') {
      return res.status(400).json({
        message: '请求包含未预期的文件字段'
      });
    }
    // 其他Multer错误（如文件过大）
    return res.status(400).json({
      message: err.message
    });
  }
  // 处理非Multer类型的错误
  res.status(500).json({
    message: '服务器内部错误'
  });
});

如果只想在特定路由捕获错误，也可以给路由单独绑定错误处理函数：

app.post('/upload', upload.single('avatar'), (req, res) => {
  // 正常上传逻辑
}, (err, req, res, next) => {
  if (err.code === 'LIMIT_UNEXPECTED_FILE') {
    return res.status(400).send('不允许上传额外的文件');
  }
  next(err); // 其他错误交给全局中间件处理
});

二、用express-validator验证文件 #

express-validator默认只处理req.body，但可以通过custom()方法自定义规则，针对req.file或req.files做验证：

示例1：验证单个文件（upload.single()场景） #

const { validationResult, custom } = require('express-validator');

app.post('/upload',
  upload.single('avatar'),
  custom((_, { req }) => {
    // 验证文件是否存在
    if (!req.file) {
      throw new Error('必须上传头像文件');
    }
    // 验证文件类型
    const allowedTypes = ['image/jpeg', 'image/png'];
    if (!allowedTypes.includes(req.file.mimetype)) {
      throw new Error('只允许上传JPG/PNG格式的图片');
    }
    // 二次验证文件大小（可选，Multer已做限制时可省略）
    if (req.file.size > 1024 * 1024) {
      throw new Error('文件大小不能超过1MB');
    }
    return true;
  }),
  (req, res) => {
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
      return res.status(400).json({ errors: errors.array() });
    }
    // 验证通过后的业务逻辑
    res.json({ message: '文件上传成功' });
  }
);

示例2：验证多个文件（upload.array()场景） #

app.post('/upload-multiple',
  upload.array('photos', 3), // 最多允许3个文件
  custom((_, { req }) => {
    if (!req.files || req.files.length === 0) {
      throw new Error('至少上传一张图片');
    }
    // 遍历验证每个文件
    req.files.forEach(file => {
      const allowedTypes = ['image/jpeg', 'image/png'];
      if (!allowedTypes.includes(file.mimetype)) {
        throw new Error(`文件${file.originalname}格式不合法，仅支持JPG/PNG`);
      }
      if (file.size > 1024 * 1024) {
        throw new Error(`文件${file.originalname}大小超过1MB限制`);
      }
    });
    return true;
  }),
  (req, res) => {
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
      return res.status(400).json({ errors: errors.array() });
    }
    res.json({ message: '批量文件上传成功' });
  }
);

若使用upload.fields()（多字段多文件），可通过req.files['字段名']获取对应字段的文件列表，再针对性做验证。

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