Multer fileFilter回调报错后Express应用卡顿问题求助

一、修复fileFilter触发的连接重置问题 #

当fileFilter返回错误时应用卡住，本质是Multer的错误未被Express错误处理中间件正确捕获，同时回调的使用需要符合Multer规范：

1. 正确使用fileFilter回调：
   拒绝文件时，调用cb传递错误对象+false（明确表示拒绝），不要仅传递错误。示例：

   const upload = multer({
     storage: storage,
     fileFilter: (req, file, cb) => {
       const allowedTypes = ['image/jpeg', 'image/png', 'image/jpg'];
       if (allowedTypes.includes(file.mimetype)) {
         cb(null, true); // 允许上传
       } else {
         // 传递错误并明确拒绝
         cb(new Error("仅允许上传JPEG/PNG/JPG格式图片"), false);
       }
     }
   });
   

2. 配置Express错误处理中间件：
   必须添加全局错误处理中间件，否则Multer抛出的错误会导致Express终止连接：

   app.use((err, req, res, next) => {
     const status = err.status || 400;
     res.status(status).send({ message: err.message });
   });
   

二、解决配置顺序引发的异常 #

你提到调整storage和upload的定义顺序后PNG能上传，这是JavaScript变量声明机制导致的：

• 若storage用const/let声明且在upload之后定义，upload初始化时storage处于暂时性死区，值为undefined，此时Multer会使用默认内存存储，Cloudinary的allowedFormats完全无效。
• 此时只有你的fileFilter在起作用，若fileFilter允许PNG，就会出现仅PNG能上传的情况。

正确顺序：必须先定义storage，再初始化upload：

// 1. 先初始化Cloudinary存储
const { CloudinaryStorage } = require("multer-storage-cloudinary");
const storage = new CloudinaryStorage({
  cloudinary,
  params: {
    folder: "BilbaoBarrios",
    allowedFormats: ["jpeg", "png", "jpg"],
  },
});

// 2. 再创建Multer上传实例
const upload = multer({
  storage: storage,
  fileFilter: (req, file, cb) => {
    const allowedTypes = ['image/jpeg', 'image/png', 'image/jpg'];
    allowedTypes.includes(file.mimetype) ? cb(null, true) : cb(new Error("仅允许上传图片"), false);
  }
});

额外提示 #

Cloudinary的allowedFormats和Multer的fileFilter是互补的：

• fileFilter在本地提前过滤无效文件，减少不必要的云端请求；
• allowedFormats作为云端二次校验，确保最终存储的文件符合要求。

内容的提问来源于stack exchange，提问作者Nicolás Garitagoitia