Node/Express：其他字段验证失败时取消Multer图片上传

方案1：用内存存储暂存文件，验证通过再写入磁盘 #

将Multer的存储方式改为memoryStorage，文件先暂存到内存中，等字段验证通过后再手动写入磁盘；若验证失败，直接丢弃内存中的文件，彻底避免不必要的磁盘写入操作。

示例代码：

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

// 配置内存存储
const storage = multer.memoryStorage();
const upload = multer({ storage: storage });

// 处理编辑请求的路由
app.post('/edit-user', upload.single('avatar'), async (req, res) => {
  try {
    // 先验证邮箱等字段
    const { email } = req.body;
    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
      return res.status(400).json({ error: '邮箱格式不合法' });
    }

    // 验证通过，将内存中的文件写入磁盘
    if (req.file) {
      const filePath = path.join(__dirname, 'uploads', req.file.originalname);
      await fs.writeFile(filePath, req.file.buffer);
    }

    // 执行后续用户编辑逻辑
    // ...

    res.json({ success: true });
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

方案2：磁盘存储下确保文件写入完成后再删除 #

若必须使用磁盘存储，不要用同步的fs.unlinkSync，改用异步的fs.promises.unlink，确保在Multer完成文件写入后再执行删除操作。同时将删除逻辑放入异常捕获中，避免因删除失败导致主流程报错。

示例代码：

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

// 磁盘存储配置
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, 'uploads/');
  },
  filename: (req, file, cb) => {
    cb(null, file.originalname);
  }
});
const upload = multer({ storage: storage });

app.post('/edit-user', upload.single('avatar'), async (req, res) => {
  let filePath = req.file ? path.join(__dirname, 'uploads', req.file.filename) : null;

  try {
    // 验证字段
    const { email } = req.body;
    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
      // 验证失败，删除已上传文件
      if (filePath) await fs.unlink(filePath);
      return res.status(400).json({ error: '邮箱格式不合法' });
    }

    // 执行后续逻辑
    // ...

    res.json({ success: true });
  } catch (err) {
    // 主流程出错时，尝试删除已上传文件
    if (filePath) {
      try {
        await fs.unlink(filePath);
      } catch (unlinkErr) {
        console.error('删除文件失败:', unlinkErr);
      }
    }
    res.status(500).json({ error: err.message });
  }
});

方案3：自定义Multer存储引擎，提前验证字段 #

自定义存储引擎，在写入文件前先检查请求字段合法性，若不合法则直接跳过写入并返回错误，从根源上避免无效文件上传。

示例代码：

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

// 自定义存储引擎
const customStorage = {
  _handleFile: async (req, file, cb) => {
    // 先验证字段
    const { email } = req.body;
    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
      // 字段不合法，不写入文件，返回错误
      return cb(new Error('邮箱格式不合法'));
    }

    // 字段合法，写入文件
    const filePath = path.join(__dirname, 'uploads', file.originalname);
    try {
      await fs.writeFile(filePath, file.stream);
      cb(null, { path: filePath, filename: file.originalname });
    } catch (err) {
      cb(err);
    }
  },
  _removeFile: (req, file, cb) => {
    fs.unlink(file.path)
      .then(() => cb(null))
      .catch(err => cb(err));
  }
};

const upload = multer({ storage: customStorage });

app.post('/edit-user', upload.single('avatar'), (req, res) => {
  // 处理Multer返回的验证错误
  if (req.fileValidationError) {
    return res.status(400).json({ error: req.fileValidationError.message });
  }

  // 执行后续逻辑
  // ...

  res.json({ success: true });
});

内容的提问来源于stack exchange，提问作者milan.dzeki