Node.js中使用Multer检查上传状态及Multa文件上传结果的问询

嘿，刚好对Multer上传这块比较熟，来给你逐个解答这些问题～

一、先纠正个小笔误：是req.files/req.file而非res.files/res.file #

首先得说，你可能打错了——Multer是把文件信息挂载到请求对象（req）上的，不是响应对象（res）。默认情况下，req.files（多文件上传时）或req.file（单文件上传时）里的，都是已经成功上传到你指定服务器路径的文件。失败的文件不会被挂载到这里，而且Multer会自动清理上传失败时产生的临时文件。

二、如何检查文件的上传状态？ #

Multer的上传状态主要通过错误捕获和检查req上的文件对象来判断，分两种场景：

1. 单文件/批量上传的整体状态

Multer的中间件会在上传过程中抛出错误（比如文件大小超限、不允许的文件类型、网络中断等），你可以通过手动调用中间件并传入回调函数来捕获这些错误：

const express = require('express');
const multer = require('multer');
const app = express();

const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, './uploads/'),
  filename: (req, file, cb) => cb(null, `${Date.now()}-${file.originalname}`)
});
const upload = multer({ 
  storage,
  limits: { fileSize: 1024 * 1024 }, // 限制1MB
  fileFilter: (req, file, cb) => {
    const allowedTypes = ['image/jpeg', 'image/png'];
    allowedTypes.includes(file.mimetype) ? cb(null, true) : cb(new Error('仅支持JPG/PNG图片'), false);
  }
});

// 单文件上传示例
app.post('/upload-single', (req, res) => {
  upload.single('avatar')(req, res, (err) => {
    if (err) {
      // 上传失败分支
      if (err instanceof multer.MulterError) {
        // Multer内置错误：比如文件超限、字段名不匹配
        return res.status(400).json({ status: 'failed', msg: err.message });
      } else {
        // 自定义错误：比如文件类型不符合要求
        return res.status(400).json({ status: 'failed', msg: err.message });
      }
    }
    // 上传成功分支
    if (!req.file) return res.status(400).json({ status: 'failed', msg: '未选择文件' });
    res.status(200).json({ 
      status: 'success', 
      fileInfo: { name: req.file.filename, path: req.file.path } 
    });
  });
});

你也可以用Express的全局错误处理中间件来统一捕获Multer错误，不用每个路由都写回调。

2. 多文件上传时的单个文件状态

默认情况下，Multer在多文件上传时，只要有一个文件出错就会停止后续上传并抛出错误。但如果你想实现“部分文件成功、部分失败”的场景，需要结合回调和req.files来判断：

// 多文件上传示例，返回每个文件的上传状态
app.post('/upload-multiple', (req, res) => {
  upload.array('photos', 5)(req, res, (err) => {
    const uploadResults = [];
    // 先收集所有成功上传的文件
    if (req.files) {
      req.files.forEach(file => {
        uploadResults.push({
          originalName: file.originalname,
          status: 'success',
          savedPath: file.path
        });
      });
    }
    // 再处理错误情况
    if (err) {
      if (err instanceof multer.MulterError) {
        // 单个文件出错，已上传的文件会保留在req.files中
        uploadResults.push({
          relatedField: err.field,
          status: 'failed',
          reason: err.message
        });
      } else {
        uploadResults.push({
          status: 'failed',
          reason: err.message
        });
      }
      // 用207状态码表示多状态响应
      return res.status(207).json({ results: uploadResults });
    }
    res.status(200).json({ results: uploadResults });
  });
});

三、如何识别“部分上传”的情况？ #

Multer本身不会主动记录“部分上传”（比如上传到一半网络中断）的文件，因为HTTP流式上传一旦中断，服务器会收到中止信号。你可以通过监听文件流的error事件来捕获这种情况：

const fs = require('fs');
const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, './uploads/'),
  filename: (req, file, cb) => {
    const savedFilename = `${Date.now()}-${file.originalname}`;
    // 监听文件流错误，捕获上传中断等异常
    file.stream.on('error', (streamErr) => {
      console.log(`文件 ${file.originalname} 上传中断:`, streamErr);
      // 可选：删除已上传的部分文件
      fs.unlink(`./uploads/${savedFilename}`, (unlinkErr) => {
        if (unlinkErr) console.log('删除部分上传文件失败:', unlinkErr);
      });
      // 可选：将状态记录到数据库/日志
    });
    cb(null, savedFilename);
  }
});

总结一下 #

1. req.files/req.file只包含完全成功上传的文件，失败的不会出现在这里；
2. 检查上传状态主要靠捕获Multer的错误（内置错误/自定义错误），以及判断req.files是否存在；
3. 部分上传的情况需要手动监听文件流事件来捕获，Multer没有内置支持，需要自己实现清理或记录逻辑。

内容的提问来源于stack exchange，提问作者Program-Me-Rev