Express+Multer上传Excel至MySQL时req.file始终为undefined问题排查求助

嘿，我之前做Excel导入功能时也踩过这个坑，咱们一步步来排查和解决：

最常见的原因：Postman请求格式错误 #

首先确认你在Postman里的请求设置：

• 请求方法必须是POST，URL是/excel/upload
• 请求体要选form-data，然后添加一个key为file（注意和路由里uploadFile.single("file")的参数完全一致）
• 这个key的类型要选File，然后选择你的Excel文件上传
• 不要手动设置Headers里的Content-Type，Postman会自动根据form-data生成正确的multipart/form-data头部

检查__basedir是否正确定义 #

你代码里用了__basedir，但如果没在项目入口文件（比如app.js或server.js）里全局定义，它会是undefined，导致multer无法找到存储目录，进而req.file为空。

在入口文件顶部添加：

global.__basedir = __dirname;

确保uploads目录存在 #

multer不会自动创建存储目录，如果__basedir + "/uploads"不存在，multer会静默失败，导致req.file为undefined。可以手动创建uploads文件夹，或者在multer的storage配置里自动创建：

const fs = require('fs');
var storage = multer.diskStorage({
  destination: (req, file, cb) => {
    const uploadDir = __basedir + "/uploads";
    // 递归创建目录（如果父目录不存在也会自动创建）
    if (!fs.existsSync(uploadDir)) {
      fs.mkdirSync(uploadDir, { recursive: true });
    }
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    console.log(file.originalname);
    cb(null, `${Date.now()}-bestfile-${file.originalname}`);
  },
});

修复multer的fileFilter错误处理 #

你的excelFilter里传递给cb的错误是字符串，正确做法应该传递Error对象，否则可能导致中间件异常：

const excelFilter = (req, file, cb) => {
  // 明确列出允许的Excel MIME类型，避免模糊匹配的问题
  const allowedMimeTypes = [
    "application/vnd.ms-excel", // .xls格式
    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" // .xlsx格式
  ];
  if (allowedMimeTypes.includes(file.mimetype)) {
    cb(null, true);
  } else {
    cb(new Error("请仅上传Excel文件（.xls 或 .xlsx格式）"), false);
  }
};

添加multer错误捕获 #

在路由里手动捕获multer的错误，这样能明确知道是文件类型不对还是存储问题：

router.post("/upload", (req, res) => {
  uploadFile.single("file")(req, res, (err) => {
    if (err) {
      return res.status(400).send({ msg: err.message });
    }
    // 错误处理完再调用控制器
    excelController.upload(req, res);
  });
});

调试技巧 #

可以在控制器的upload函数里先打印req.files（注意是复数）和req.body，看看有没有文件相关的信息，或者是否是表单字段名不匹配的问题。

按照上面的步骤排查，应该能解决req.file为undefined的问题。如果还有问题，可以看看控制台有没有报错信息，比如权限问题（uploads目录没有写权限）或者MIME类型匹配失败的提示。

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