Multer中间件未调用求助：upload.single()无响应问题排查

我帮你梳理几个最可能的原因，按优先级来排查：

• 表单缺少enctype="multipart/form-data"属性
  这是文件上传的核心要求！浏览器默认的表单编码类型没法处理文件数据，所以Multer的中间件根本不会被触发。修改你的表单代码，加上这个属性：

  <form action="/product/addnew" method="post" enctype="multipart/form-data">
    <div class="form-group row">
      <label><input type="file" id="photo" name="photo" class="form-control"/></label>
    </div>
    <div class="form-group row">
      <button type="submit" class="btn btn-primary">Add Product</button>
    </div>
  </form>
  

• 确认uploads目录是否存在
  Multer不会自动创建目标存储目录，如果./uploads/不存在，会抛出文件系统错误，导致中间件执行失败。你可以手动创建这个目录，或者在代码里加上目录检测：

  const fs = require('fs');
  const uploadDir = './uploads/';
  if (!fs.existsSync(uploadDir)) {
    fs.mkdirSync(uploadDir, { recursive: true });
  }
  

• 检查前置中间件是否拦截了请求
  你的路由里先用了auth.isLoggedIn中间件，要确保这个中间件在验证通过后调用了next()，如果它在未登录时直接发送了响应（比如res.redirect或res.send），后续的upload.single()就不会被执行。可以检查auth.isLoggedIn的逻辑：

  // 示例正确的auth中间件逻辑
  isLoggedIn: (req, res, next) => {
    if (req.isAuthenticated()) {
      return next(); // 必须调用next才能执行后续中间件
    }
    res.redirect('/login');
  }
  

• 验证文件过滤函数的行为
  你的fileFilter在拒绝文件时只返回false，不会抛出错误，这时候req.file会是undefined，但中间件其实是被调用了。可以修改过滤函数，在拒绝时传递错误，方便排查：

  const fileFilter = (req, file, cb) => {
    if (file.mimetype === 'image/jpeg' || file.mimetype === 'image/png') {
      cb(null, true);
    } else {
      cb(new Error('只允许上传JPEG或PNG格式的图片'), false); // 传递错误
    }
  };
  

  然后在路由里加上错误处理，看是否是文件类型问题导致的：

  router.post('/addnew', auth.isLoggedIn, upload.single('photo'), (req, res, next) => {
    console.log('file:', req.file);
  }, (err, req, res, next) => {
    // 处理Multer的错误
    res.status(400).send(err.message);
  });
  

• 确认字段名完全匹配
  虽然你的代码里upload.single('photo')和表单的name="photo"是一致的，但还是要仔细检查有没有拼写错误（比如大小写、多打少打字符），字段名不匹配的话，Multer也找不到对应的文件。

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