Multer文件大小超限未触发错误处理，如何阻止大文件上传？

问题根源拆解 #

1. 自定义中间件的无效性 #

你现在写的中间件逻辑本质上是先完成文件上传再做检测：每次调用multer({...}).single("file")都会创建一个全新的Multer实例，而Multer传给你的回调函数是在文件已经完全写入存储目标（比如GridFS）之后才触发的，所以这个检测完全无法从源头阻止大文件上传，只是事后判断而已。

2. limits选项无效的可能原因 #

• 实例创建方式错误：你在中间件内部每次都新建Multer实例，可能导致配置的limits没有被稳定应用；
• 未处理Multer错误：Multer检测到文件超限时会抛出MulterError（错误码LIMIT_FILE_SIZE），如果没有专门的错误处理逻辑捕获这个错误，请求会挂起，看起来像是limits没生效；
• 单位混淆：虽然你写的4000000是4MB（字节），但建议用4 * 1024 * 1024这种更清晰的写法，避免后续维护时误解。

3. 页面冻结的原因 #

你尝试的方案大概率是没有正确处理Multer的错误，导致错误未被捕获，请求一直处于未响应状态，浏览器持续等待服务器回复，最终表现为页面冻结无报错。

正确解决方案 #

步骤1：全局创建Multer实例 #

不要在中间件里重复创建实例，一次性配置好存储和限制：

const multer = require('multer');
// 假设你的grid存储配置已经定义好
const upload = multer({
  storage: grid,
  limits: { fileSize: 4 * 1024 * 1024 } // 明确设置为4MB
});

步骤2：使用Multer中间件并添加错误处理 #

直接用上面的实例作为路由中间件，然后通过全局错误处理中间件捕获Multer的文件大小错误：

// 上传接口路由
app.post('/upload', upload.single('file'), (req, res) => {
  // 文件上传成功后的业务逻辑
  res.status(200).send('文件上传成功');
});

// 全局错误处理中间件，必须放在所有路由之后
app.use((err, req, res, next) => {
  // 捕获Multer相关错误
  if (err instanceof multer.MulterError) {
    if (err.code === 'LIMIT_FILE_SIZE') {
      return res.status(413).send('文件大小超出限制，上传已取消。');
    }
    // 其他Multer错误，比如文件字段错误
    return res.status(400).send(err.message);
  }
  // 处理其他非Multer错误
  next(err);
});

关键说明 #

• 这个方案会在Multer接收文件流的过程中实时检测大小，一旦超出限制就立即终止上传，不会将大文件写入存储；
• 错误处理中间件必须放在所有路由之后，才能捕获到路由中抛出的错误；
• 如果使用GridFS作为存储，Multer的limits依然会生效，因为大小检测是在文件写入存储之前的流处理阶段完成的。

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