使用ng-file-upload+Node.js multer上传文件时req.file始终为undefined求助

我碰到过好几个开发者遇到这个问题，req.file一直是undefined大概率是请求格式、参数名不匹配或者multer配置的问题，咱们一步步来排查和解决：

1. 先确认客户端与服务端的字段名完全匹配 #

这是最常见的原因！multer的single('fieldname')方法里的字段名，必须和你ng-file-upload上传时传入的data键名完全一致。

举个例子：

• 如果服务端用的是 upload.single('userFile')，那客户端上传代码里的data必须是：

  Upload.upload({
    url: '/your-upload-endpoint',
    data: { userFile: $scope.selectedFile } // 这里的key必须是'userFile'
  })
  

• 同时，视图里的input最好也指定name属性（虽然ng-file-upload主要靠data里的键，但保险起见）：

  <input type="file" name="userFile" nv-file-select ng-model="selectedFile" accept="application/pdf,application/msword,...">
  

2. 禁止手动设置Content-Type #

ng-file-upload会自动帮你生成正确的multipart/form-data请求头（包含boundary分隔符），如果你手动设置了这个header，反而会导致服务端无法解析文件：
❌ 错误做法：

Upload.upload({
  url: '/your-upload-endpoint',
  headers: { 'Content-Type': 'multipart/form-data' }, // 不要加这个！
  data: { file: $scope.selectedFile }
})

✅ 正确做法：完全去掉手动设置的Content-Type，让ng-file-upload自动处理。

3. 检查multer的基础配置 #

• 确保存储目录存在且有权限：如果用multer({ dest: 'uploads/' })，要先在项目根目录创建uploads文件夹，并且Node进程有写入该文件夹的权限（比如Linux/macOS下可以用chmod 755 uploads调整权限）。
• 使用正确的multer方法：单文件上传用single('fieldname')，多文件用array('fieldname', maxCount)，如果是多个不同字段的文件用fields([{name: 'file1'}, {name: 'file2'}])，别用错方法。

4. 排查客户端上传函数的正确性 #

确保你的uploadFile()函数正确获取了文件对象，比如：

$scope.uploadFile = function() {
  // 先确认$scope.selectedFile是有效的文件对象
  if (!$scope.selectedFile) {
    console.log('请先选择文件');
    return;
  }
  
  Upload.upload({
    url: '/api/upload',
    data: {
      file: $scope.selectedFile
    }
  }).then(function(resp) {
    console.log('文件上传成功：', resp.data);
  }, function(err) {
    console.error('上传失败：', err);
  });
};

同时要确保已经在Angular模块中引入了ngFileUpload：

angular.module('yourApp', ['ngFileUpload']);

5. 服务端路由的正确配置 #

• 不要在multer中间件之前使用body-parser处理multipart/form-data，multer会自行解析这类请求，body-parser会干扰解析过程。
• 确保multer中间件正确绑定到路由上：

const express = require('express');
const multer = require('multer');
const app = express();

// 配置multer存储
const upload = multer({ dest: 'uploads/' });

// 绑定中间件到上传路由
app.post('/api/upload', upload.single('file'), (req, res) => {
  if (!req.file) {
    return res.status(400).send('未检测到上传的文件');
  }
  // 这里可以处理文件，比如重命名、存储到数据库等
  res.json({
    message: '文件上传成功',
    fileInfo: req.file
  });
});

按照上面的步骤逐一排查，应该就能解决req.file为undefined的问题了！

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