为何multer.diskStorage()未被调用？Node.js上传接口报错排查

1. 确认multer实例正确关联diskStorage配置 #

你大概率是创建multer实例时没指定storage选项，导致multer用默认的内存存储，根本不会触发diskStorage的回调。正确写法如下：

const multer = require('multer');
const fs = require('fs');

const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    const uploadDir = './uploads';
    // 确保上传目录存在，避免创建失败
    if (!fs.existsSync(uploadDir)) {
      fs.mkdirSync(uploadDir, { recursive: true });
    }
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    console.log("hello");
    // 生成唯一文件名避免覆盖
    const uniqueName = `${Date.now()}-${Math.random().toString(36).slice(2)}-${file.originalname}`;
    cb(null, uniqueName);
  }
});

// 必须把storage传入multer实例
const upload = multer({ storage: storage });

2. 检查路由是否正确挂载multer中间件 #

如果没在上传接口里添加multer的文件解析中间件，req.file会是undefined，自然会报读取filename的错误，同时diskStorage回调也不会执行。示例路由写法：

// 假设你的前端传文件的字段名是"image"，要和single()里的参数一致
app.post('/api/upload', upload.single('image'), (req, res) => {
  // 先判断是否有文件上传
  if (!req.file) {
    return res.status(400).json({ message: '未上传文件' });
  }
  // 这里才能安全访问req.file.filename
  const image_url = `/uploads/${req.file.filename}`;
  res.json({ image_url });
});

3. 核对前端请求的字段名 #

用Thunder Client测试时，form-data的键名必须和upload.single('xxx')里的xxx完全一致（比如上面的image）。如果字段名不匹配，multer识别不到文件，req.file还是undefined。

4. 排查目录权限问题 #

确保你的Node进程有读写./uploads目录的权限，部分系统下可能因为权限不足导致multer无法写入文件，进而触发隐性错误。

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