Node.js使用multer实现文件上传时无法存储文件及字符串数据问题咨询

核心优先排查项 #

你贴出的req.files返回结果中包含mv方法，这是express-fileupload中间件的典型输出，你大概率同时引入了express-fileupload和multer两个文件上传中间件，二者产生了冲突：
express-fileupload会提前解析请求中的文件，写入内存并覆盖req.files字段，导致multer的磁盘存储逻辑完全没有执行，自然不会生成文件到storage目录。
解决方法：直接删除项目中express-fileupload的引入和app.use(fileUpload())相关代码即可。

其他常规排查步骤 #

• 检查storage目录的路径与权限
  你配置的路径./storage是相对于项目启动目录的相对路径，而非当前代码文件的相对路径：

  1. 手动在项目根目录（执行node启动命令的目录）创建storage文件夹
  2. 给文件夹赋予读写权限：Linux环境执行chmod 755 ./storage，Windows环境右键取消文件夹的「只读」属性
  3. 避免相对路径歧义可以改用绝对路径配置：

  const path = require('path')
  let storage = multer.diskStorage({
    destination: function (req, file, cb) {
        // 指向当前代码文件同级的storage目录，路径不会随启动位置变化
        cb(null, path.join(__dirname, './storage'))
    },
    filename: function (req, file, cb) {
        cb(null, file.originalname + '-' + Date.now())
    }
  });
  

• 调整multer配置，过滤拦截问题
  你提到只有upload.single("filename")可以正常读取文件，说明前端上传文件的字段名为filename，优先使用明确的字段配置而非upload.any()，同时添加过滤和错误捕获：

const upload = multer({
  storage: storage,
  // 允许的文件类型校验，可以按需扩展
  fileFilter: function (req, file, cb) {
    const allowMimeTypes = ['image/png', 'image/jpeg', 'application/pdf']
    if (allowMimeTypes.includes(file.mimetype)) {
      cb(null, true)
    } else {
      cb(new Error('不支持的文件类型'), false)
    }
  },
  // 限制单文件最大为10M，避免超大文件被静默拦截
  limits: { fileSize: 10 * 1024 * 1024 }
})

// 路由配置改用明确的array配置，对应前端的filename字段，支持多文件上传
.post(
  middlewares.UserRolesMiddleware(userTypes.teacher),  
  upload.array("filename", 10), // 第二个参数是最多允许上传的文件数量
  function(req, res, next) {
    // upload.array返回的req.files是数组，直接遍历即可
    if (req.files && req.files.length > 0) {
      console.log('已存储的文件列表：', req.files)
      return res.end("文件上传成功");
    }
    res.end("未检测到上传文件");
  }
);

• 添加multer错误捕获，定位隐藏报错
  如果前面的步骤都没有解决，给multer加显式错误捕获，查看是否有内部报错：

.post(
  middlewares.UserRolesMiddleware(userTypes.teacher),
  function(req, res, next) {
    // 手动执行upload中间件，捕获报错
    upload.array("filename", 10)(req, res, function (err) {
      if (err) {
        console.log('multer上传报错：', err)
        return res.status(500).end('上传失败：' + err.message)
      }
      // 原有业务逻辑
      if (req.files && req.files.length > 0) {
        return res.end("文件上传成功");
      }
      res.end("未检测到上传文件");
    })
  }
)

内容的提问来源于stack exchange，提问作者Syed Anas Shah