Express中使用Multer上传文件时如何在后续中间件前处理异常

你可以将Multer执行逻辑与错误处理封装为独立的前置中间件，放在路由中间件数组的首位，即可保证异常捕获完成后再执行后续自定义中间件。

步骤1：封装带错误处理的Multer中间件 #

const multer = require('multer')
// 按自身业务需求配置Multer参数，比如存储路径、文件大小限制、文件类型过滤等
const multerInstance = multer({
  // 示例：限制单文件最大10MB
  limits: { fileSize: 10 * 1024 * 1024 }
}).single('avatar') // 对应你上传的文件字段名，多文件可换用array/fields等方法

// 封装独立的Multer错误处理中间件
const multerErrorCatcher = (req, res, next) => {
  multerInstance(req, res, (err) => {
    if (err instanceof multer.MulterError) {
      // 处理Multer专属异常，可根据err.code做细分处理
      return res.status(400).json({
        error: 'FILE_UPLOAD_FAILED',
        message: `上传错误：${err.message}`
      })
    } else if (err) {
      // 处理非Multer类的未知上传异常
      return res.status(500).json({
        error: 'SERVER_ERROR',
        message: `服务器异常：${err.message}`
      })
    }
    // 无异常则进入下一个中间件
    next()
  })
}

步骤2：调整路由中间件顺序 #

将封装好的multerErrorCatcher放在中间件数组的第一个位置即可：

app.post('/profile', [
  multerErrorCatcher, // 优先执行上传解析与异常捕获
  middlewareFunctions.Authenticate,
  middlewareFunctions.getDataUploadedFile
], function (req, res) {
  // 执行到此处时上传已无异常，req.file/req.body已被Multer正常解析
  // 后续业务逻辑直接调用即可
})

该方案适配Multer 1.4.x及以上所有主流版本，完全符合Express中间件的执行顺序规则，不需要额外引入第三方依赖。

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