Node.js Express中multer上传图片无报错但req.file为空问题排查

针对你遇到的Express项目中Multer上传图片时req.file为空的问题，结合你提供的代码，可从以下几个方向排查：

• 确认目标上传文件夹存在
  你的Multer配置中指定的上传目录是"Images"，但Multer不会自动创建不存在的目录。如果项目根目录下没有这个文件夹，上传会静默失败，导致req.file为空。
  解决方法：手动在项目根目录创建Images文件夹，或者在Multer配置中加入目录创建逻辑：

  const fs = require('fs');
  const storage = multer.diskStorage({
    destination: (req, file, cb) => {
      const dir = "Images";
      if (!fs.existsSync(dir)) {
        fs.mkdirSync(dir);
      }
      cb(null, dir);
    },
    filename:(req,file,cb)=>{
        console.log(file);
        cb(null,Date.now()+path.extname(file.originalname))
    }
  });
  

• 验证中间件导入与路由挂载路径
  检查../middlewares/multer的相对路径是否正确，确保文件位置和导入路径匹配。同时确认admin路由的挂载是否正确，比如你的Express主文件中是否有类似：

  const adminRouter = require('./routes/admin');
  app.use('/admin', adminRouter);
  

  若路由挂载路径错误，表单提交的/admin/add-product-1会无法匹配到对应的处理接口，导致req.file为空。

• 检查表单字段名与Multer配置的一致性
  虽然你的代码中upload.single('image')和表单的<input type="file" name="image">字段名一致，但需注意大小写敏感，确保没有拼写错误（比如写成Image或img）。

• 排查其他中间件的干扰
  确保没有在Multer中间件之前使用会解析multipart/form-data的其他中间件，也不要在路由前提前使用express.urlencoded()处理该类型的请求（express.urlencoded()仅用于application/x-www-form-urlencoded类型）。如果有这类中间件，会提前消耗请求流，导致Multer无法获取文件数据。

• 测试文件大小是否超出限制
  你设置了5MB的文件大小限制，尝试上传一个小于5MB的图片测试。如果上传的文件超出限制，Multer会静默忽略文件，导致req.file为空。可临时注释limits配置，验证是否是大小限制导致的问题。

• 简化Multer配置排查问题
  暂时替换你的diskStorage配置为简单的dest模式，测试是否能正常上传：

  const upload = multer({ dest: 'Images/' });
  

  如果此配置下req.file有值，说明问题出在diskStorage的回调逻辑中，比如filename里的console.log(file)是否有输出，或者路径拼接是否存在问题。

内容的提问来源于stack exchange，提问作者Abin T H