Node.js多字段文件上传异常：无法接收txt文件报500错误

在Node.js中基于multer实现多字段文件上传（html_template 用于传txt文件，preview_image 传图片）时遇到异常：

• 上传txt文件时，Postman返回内部服务器错误，控制台无错误日志输出
• 仅上传preview_image字段时，jpg/jpeg/png等图片可正常完成上传与数据库存储
• 尝试过upload.fields()和upload.any()两种方式，问题依旧

相关代码片段如下：

multer配置函数 #

var storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, "src/uploads/");
  },
  filename: function (req, file, cb) {
    cb(
      null,
      file.fieldname + "-" + Date.now() + path.extname(file.originalname)
    );
  },
});

var upload = multer({
  storage: storage,
  fileFilter: function (req, file, cb) {
    var filetypes = /jpeg|jpg|png|pdf|txt/;
    var mimetype = filetypes.test(file.mimetype);
    var extname = filetypes.test(path.extname(file.originalname).toLowerCase());
    if (mimetype && extname) {
      return cb(null, true);
    }
    cb("Please upload valid file");
  },
});

创建模板路由 #

router
  .route("/create")
  .post(
    upload.fields([{ name: "html_template" }, { name: "preview_image" }]),
    Template.createTemplate
  );

控制器函数 #

exports.createTemplate = catchAsync(async (req, res) => {
  try {
    console.log(req.files);
    const template = await templateService.createTemplate(req);
    return res.succeed(template, "Template created successfully");
  } catch (error) {
    console.trace(error);
    return res.failed(500, "Internal Server Error", error);
  }
});

服务函数 #

exports.createTemplate = async (req) => {
  const name = req.body.name;
  const html_template = req.files.html_template;
  const preview_image = req.files.preview_image;

  const imagePath = preview_image.map((image) => image.path);

  const template = new Template({
    name,
    html_template,
    preview_image: imagePath.toString(),
  });
  await template.save();
  return template;
};

1. 核心问题：MIME类型匹配逻辑错误 #

你的正则/jpeg|jpg|png|pdf|txt/是直接匹配字符串，但txt文件的MIME类型是text/plain，这个字符串里没有"txt"子串，导致filetypes.test(file.mimetype)返回false，触发fileFilter的错误回调。而图片的MIME类型（比如image/jpeg）包含"jpeg"子串，所以能通过校验。

2. 次要问题：错误处理不规范 #

multer的fileFilter中直接传字符串给cb，会导致错误被当作中间件级别的异常抛出，而你的控制器try/catch无法捕获这个阶段的错误，所以控制台看不到日志，直接返回500错误。

修复步骤 #

（1）修正MIME类型与扩展名校验逻辑

把fileFilter改成针对允许的扩展名和MIME类型做精准匹配：

var upload = multer({
  storage: storage,
  fileFilter: function (req, file, cb) {
    // 定义允许的扩展名和对应的MIME类型
    const allowedExtensions = ['.jpeg', '.jpg', '.png', '.pdf', '.txt'];
    const allowedMimeTypes = [
      'image/jpeg', 
      'image/png', 
      'application/pdf', 
      'text/plain'
    ];

    const fileExtension = path.extname(file.originalname).toLowerCase();
    const fileMimeType = file.mimetype;

    // 同时校验扩展名和MIME类型
    if (allowedExtensions.includes(fileExtension) && allowedMimeTypes.includes(fileMimeType)) {
      return cb(null, true);
    }
    // 必须传Error对象，而非字符串
    cb(new Error('请上传有效的文件类型：jpeg/jpg/png/pdf/txt'));
  },
});

（2）捕获multer中间件的错误

在路由中手动处理multer的错误，避免错误直接抛出到全局：

router.route("/create")
  .post(
    (req, res, next) => {
      // 手动调用upload中间件，捕获错误
      upload.fields([{ name: "html_template" }, { name: "preview_image" }])(req, res, function(err) {
        if (err) {
          console.error('文件上传错误:', err);
          return res.failed(400, "文件上传失败", err.message);
        }
        // 无错误则进入控制器
        next();
      });
    },
    Template.createTemplate
  );

（3）统一文件存储逻辑（可选）

服务函数中html_template直接存了文件对象，而preview_image存的是路径，建议统一处理成路径存储，避免数据库字段类型不匹配：

exports.createTemplate = async (req) => {
  const name = req.body.name;
  const html_template = req.files.html_template;
  const preview_image = req.files.preview_image;

  const imagePath = preview_image.map((image) => image.path);
  // 对html_template做同样的路径提取
  const htmlTemplatePath = html_template.map(file => file.path);

  const template = new Template({
    name,
    html_template: htmlTemplatePath.toString(),
    preview_image: imagePath.toString(),
  });
  await template.save();
  return template;
};

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