集成项目后express-fileupload无法获取文件，req.files为undefined问题排查

核心问题定位 #

POC脚本正常但集成后失效，说明问题出在项目的中间件顺序、multer配置或请求格式上，而非GCP上传逻辑本身。

逐一排查解决步骤 #

1. 确认multer中间件的挂载顺序 #

multer必须在路由注册之前挂载，否则无法对路由生效。如果是全局挂载app.use(upload(...))，要确保它在所有app.use('/api', router)或app.post(...)之前；如果是路由级挂载，要在路由处理函数前传入upload中间件。

错误示例（路由先注册，multer后挂载）：

// ❌ 错误：路由已注册，multer不会作用到该路由
app.post('/upload-video', (req, res) => { ... });
app.use(upload({ useTempFiles: true, tempFileDir: '/tempFolder/' }));

正确示例：

// ✅ 正确：先配置multer，再注册路由
const upload = multer({ 
  useTempFiles: true, 
  tempFileDir: `${__dirname}/tempFolder/` // 推荐用绝对路径，避免目录找不到
});
app.post('/upload-video', upload.fields([{ name: 'video' }]), (req, res) => { ... });

2. 检查bodyParser与multer的冲突 #

bodyParser仅处理application/json和application/x-www-form-urlencoded类型的请求，不要让它处理multipart/form-data（multer会专门处理这种类型）。确保你的bodyParser配置是：

// ✅ 正确的bodyParser配置
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

避免使用app.use(bodyParser())这种旧写法，也不要添加type: 'multipart/form-data'的配置项。

3. 验证Postman请求格式 #

这是最容易忽略的点：

• 请求方法必须是POST
• Body选择form-data格式
• 表单key必须和你multer配置中的name完全一致（比如upload.fields([{name: 'video'}])，则key必须是video）
• key的类型要选File，然后选择本地视频文件上传
• 不要手动设置Content-Type头，Postman会自动生成带boundary的multipart/form-data头

4. 检查multer临时目录配置 #

确保tempFileDir的路径存在且服务器有读写权限：

• 用绝对路径替代相对路径，比如path.resolve(__dirname, 'tempFolder')
• 手动创建tempFolder目录，避免multer因目录不存在报错
• 检查目录权限，确保Node进程能读写该目录

5. 对比POC与项目代码的差异 #

• 看POC中multer是全局挂载还是路由级挂载，项目中是否保持一致
• 检查项目中是否有其他中间件（比如权限校验、日志中间件）提前终止了请求，导致multer未执行
• 确认项目中是否安装了正确版本的multer（POC和项目的依赖版本一致）

验证测试 #

完成上述配置后，在路由处理函数中先打印req.files和req.body，确认文件是否被正确解析：

app.post('/upload-video', upload.fields([{ name: 'video' }]), (req, res) => {
  console.log('Received files:', req.files);
  console.log('Received body:', req.body);
  // 后续GCP上传逻辑
});

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