Node.js/Express：Multer S3上传前用Joi校验multipart/form-data

问题根源 #

Express 默认的 express.json() 和 express.urlencoded() 中间件不会解析 multipart/form-data 格式的请求体。如果在 Multer 文件上传中间件之前直接执行校验逻辑，此时 req.body 是空对象，Joi 自然会报 folderPath is required 的错误。

解决方案：先解析普通字段，再校验，最后处理文件上传 #

我们可以先用 Multer 仅解析请求中的普通文本字段（不处理文件），拿到 folderPath 后执行 Joi 校验，校验通过再触发文件上传流程，这样就能避免无效的文件上传消耗带宽和存储。

具体实现步骤 #

1. 添加仅解析普通字段的 Multer 中间件：使用 multer().none()，它会解析 multipart/form-data 里的所有文本字段并挂载到 req.body，同时拒绝接收任何文件（避免提前消耗带宽）。
2. 执行 Joi 校验逻辑：在拿到解析后的 req.body 后，用 Joi 校验 folderPath 参数的合法性。
3. 执行文件上传中间件：校验通过后，再调用处理 AWS S3 上传的 fileUploadMiddleware.uploadImages。

代码示例 #

路由配置

const express = require('express');
const multer = require('multer');
const router = express.Router();
const fileUploadMiddleware = require('./your-file-upload-middleware');
const validateRequest = require('./your-validate-middleware');

// 先解析multipart/form-data的普通字段
const parseTextFields = multer().none();

router.post('/upload', 
  parseTextFields, 
  validateRequest, 
  fileUploadMiddleware.uploadImages, 
  (req, res) => {
    // 处理上传成功后的响应
    res.status(200).json({ message: '文件上传成功', data: req.files });
  }
);

Joi 校验中间件示例（validateRequest）

const Joi = require('joi');

const validateRequest = (req, res, next) => {
  const schema = Joi.object({
    folderPath: Joi.string().required().messages({
      'string.empty': 'folderPath 不能为空',
      'any.required': 'folderPath 是必填字段'
    })
  });

  const { error } = schema.validate(req.body);
  if (error) {
    return res.status(400).json({ error: error.details[0].message });
  }
  next();
};

module.exports = validateRequest;

注意事项 #

• multer().none() 会拒绝任何文件上传请求，如果请求中包含文件，这个中间件会直接返回 400 错误。但这正是我们需要的：如果校验不通过，不会接收文件；校验通过后，后续的 uploadImages 中间件会正常处理文件。
• 确保你的文件上传中间件（uploadImages）是基于 Multer 配置的，比如使用 multer-s3，这样它能正确处理后续的文件流。

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