Multer上传前验证时req.body为空的解决方案咨询

问题原因 #

当请求是multipart/form-data格式（带文件上传的请求默认使用该格式）时，Express本身不会自动解析这类请求体。只有在multer执行完毕后，才会将请求中的表单数据解析到req.body、文件数据解析到req.file中。所以你把validator放在upload.single前面时，请求体还未被解析，自然req.body为空。

方案一：先解析请求到内存，验证通过后再保存文件 #

这种方式先把文件临时存储在内存中，验证用户信息无误后再写入磁盘，不会产生无效文件残留：

const multer = require('multer');
const fs = require('fs');
const path = require('path');

// 使用内存存储临时存放上传的文件
const memoryStorage = multer.memoryStorage();
const upload = multer({ storage: memoryStorage });

// 验证中间件，此时req.body已被multer解析完成
const validator = (req, res, next) => {
  const { username, email } = req.body;
  // 示例验证逻辑，可根据实际需求修改
  if (!username || !email) {
    return res.status(400).send('用户名和邮箱不能为空');
  }
  // 添加其他验证规则：比如邮箱格式校验、密码长度校验等
  next();
};

// 验证通过后，将内存中的文件写入磁盘
const saveProfilePic = (req, res, next) => {
  if (!req.file) return next(); // 无上传文件则直接跳过
  
  const uniqueSuffix = Date.now() + "-" + req.file.originalname.toLowerCase();
  const filePath = path.join(__dirname, 'public/profile_pic', uniqueSuffix);
  
  fs.writeFile(filePath, req.file.buffer, (err) => {
    if (err) {
      console.error('头像保存失败：', err);
      return res.status(500).send('头像上传失败');
    }
    // 将文件名存入req，后续创建用户时可关联使用
    req.profilePicName = uniqueSuffix;
    next();
  });
};

// 路由顺序：先解析请求 → 验证信息 → 保存文件 → 处理用户创建
router.post("/signup", upload.single("profile"), validator, saveProfilePic, (req, res) => {
  console.log('用户信息：', req.body);
  console.log('头像文件名：', req.profilePicName);
  // 此处执行创建用户的业务逻辑
  res.status(200).send('用户创建成功');
});

方案二：先保存文件，验证失败后删除无效文件 #

这种方式直接使用磁盘存储，multer会先将文件保存到指定目录，验证不通过时再删除已上传的文件：

const multer = require('multer');
const fs = require('fs');
const path = require('path');

let uniqueSuffix;
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, "public/profile_pic");
  },
  filename: (req, file, cb) => {
    uniqueSuffix = Date.now() + "-" + file.originalname.toLowerCase();
    cb(null, uniqueSuffix);
    // 将文件名存入req，方便后续删除或使用
    req.profilePicName = uniqueSuffix;
  },
});

const upload = multer({ storage });

const validator = (req, res, next) => {
  const { username, email } = req.body;
  // 验证逻辑
  if (!username || !email) {
    // 验证失败，删除已上传的无效头像
    if (req.profilePicName) {
      const filePath = path.join(__dirname, 'public/profile_pic', req.profilePicName);
      fs.unlink(filePath, (err) => {
        if (err) console.error('删除无效头像失败：', err);
      });
    }
    return res.status(400).send('用户名和邮箱不能为空');
  }
  next();
};

// 路由顺序：先上传文件 → 验证信息 → 处理用户创建
router.post("/signup", upload.single("profile"), validator, (req, res) => {
  console.log('用户信息：', req.body);
  console.log('头像文件名：', req.profilePicName);
  // 此处执行创建用户的业务逻辑
  res.status(200).send('用户创建成功');
});

注意事项 #

• 优先推荐方案一，避免产生无效临时文件，减少磁盘空间浪费；
• 使用方案二时，需注意文件删除的异常处理，防止删除失败导致文件残留；
• 验证逻辑需根据实际业务需求调整，比如添加手机号格式校验、密码复杂度校验等。

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