使用Multer上传文件时文件未保存且无相关日志该如何解决

问题原因 #

你遇到的问题核心是Multer没有正常触发文件解析逻辑，主要有以下几个原因：

• 请求被提前解析：你在调用Multer的uploadImage方法之前就可以打印req.files，说明你在全局/路由之前已经注册了其他multipart/form-data解析中间件（比如express-fileupload、multiparty等），请求的数据流已经被消费完毕，Multer拿到空流后不会触发任何内部处理逻辑，自然fileFilter、storage相关的日志都不会输出。
• 字段名不匹配：你使用了.single('photo')配置，要求前端上传时的文件字段名必须严格为photo，如果前端传的字段名不符，Multer不会匹配到对应文件，不会进入后续处理流程。
• 限制参数配置错误：你写的limits: { fieldSize: 1024 * 1024 }中fieldSize是用来限制普通表单字段的大小，限制上传文件大小需要使用fileSize参数。
• 目标目录不存在：Multer不会自动创建存储目录，如果项目根目录下没有手动创建uploads文件夹，后续写入文件时会报错。

解决方案 #

1. 移除全局注册的其他multipart/form-data解析中间件，不要在app.use()层面注册文件解析类的包，仅在需要处理文件上传的路由中使用Multer处理即可。
2. 确认前端上传的文件字段名和.single('photo')中的photo完全一致，如果是多文件上传，可替换为.array('photo', 最大上传数量)或者.fields()配置。
3. 修正文件大小限制配置：

const uploadImage = multer({
  storage,
  // 修正为fileSize限制文件大小，单位为字节，以下配置为1MB
  limits: { fileSize: 1024 * 1024 },
  // 其余配置不变
  fileFilter: (req, file, cb) => {
    // ...原有逻辑
  }
}).single('photo');

4. 手动在项目根目录创建uploads文件夹，或者在服务启动时通过fs模块自动判断创建，示例代码如下：

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

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