Multer单路由下如何配置不同存储与大小限制的多文件上传

Multer完全支持这类同路由下、不同上传字段差异化配置处理规则的场景，无需切换其他multipart解析器。你之前使用单实例upload.fields()无法满足需求的核心原因是，单实例Multer的全局storage、limits配置会统一作用于所有上传字段，无法给video和thumbnail两个字段分别绑定磁盘直写/内存暂存、2GB/20MB的差异化规则，只要拆分为对应字段的独立Multer实例，即可实现目标。

很多开发者对双独立Multer中间件挂载存在认知误区，实际运行逻辑如下：

• 每个绑定特定字段名的single()中间件，只会从请求的multipart流中提取匹配字段的文件内容，其余流数据会原样透传给下一个中间件，不会出现multipart流被提前消费、后续中间件无法读取的问题。
• 每个实例的大小限制、存储规则完全独立：视频实例的2GB校验、磁盘直写逻辑，和缩略图实例的20MB校验、内存暂存逻辑不会互相干扰。
• 常见踩坑提醒：很多开发者尝试挂载两个独立single()中间件时遇到文件信息丢失的问题，本质是没有配置fileProperty——Multer的single()默认会把处理好的文件对象挂载到req.file，两个中间件依次执行时，后执行的中间件会把前一个中间件写入的内容覆盖掉，看起来就像前一个字段的解析失败了。只要给每个实例指定独立的自定义挂载属性，就可以完全避免这个问题。

const express = require('express')
const multer = require('multer')
const app = express()

// 1. 独立配置视频文件处理规则：磁盘存储、2GB大小上限
const videoUpload = multer({
  storage: multer.diskStorage({
    destination: (req, file, cb) => {
      cb(null, 'public/videos')
    },
    filename: (req, file, cb) => {
      // 可根据业务需求生成不重复的文件名，避免覆盖
      cb(null, `${Date.now()}-${file.originalname}`)
    }
  }),
  limits: {
    fileSize: 2 * 1024 * 1024 * 1024
  },
  // 指定文件对象挂载到req.video，避免被其他中间件覆盖
  fileProperty: 'video'
}).single('video')

// 2. 独立配置缩略图处理规则：内存暂存、20MB大小上限
const thumbUpload = multer({
  storage: multer.memoryStorage(),
  limits: {
    fileSize: 20 * 1024 * 1024
  },
  // 指定文件对象挂载到req.thumbnail，避免被其他中间件覆盖
  fileProperty: 'thumbnail'
}).single('thumbnail')

// 3. 路由上按顺序挂载两个独立中间件
app.post('/upload', videoUpload, thumbUpload, (req, res) => {
  // req.video为视频文件信息，包含磁盘存储路径
  // req.thumbnail为缩略图对象，内置buffer字段，可直接传入sharp处理尺寸
  const thumbnailBuffer = req.thumbnail.buffer
  // sharp处理完成后，将最终文件写入public/video/thumbnails目录即可
  res.send('上传处理完成')
})

• 视频文件由独立的磁盘存储实例直接写入public/videos目录，全程不会占用内存资源，大小超过2GB时会被对应实例直接拦截抛出错误
• 缩略图文件由独立的内存存储实例暂存为Buffer，大小超过20MB时会被对应实例直接拦截，获取到Buffer后可直接传入sharp调整尺寸
• 路由处理函数中可分别通过req.video、req.thumbnail获取两个字段的上传信息，不会出现属性覆盖的问题

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