MEAN项目：Multer导致请求体为空的问题排查与解决

原因 #

前端用FormData传递数据时，请求的Content-Type是multipart/form-data，而Express默认的解析中间件（express.json()、express.urlencoded()）只能处理JSON或表单编码格式，无法解析multipart/form-data类型的请求体。

• 登录接口没加multer中间件，Express无法解析FormData里的文本字段，所以req.body为空。
• 注册接口加了upload.single('profile_photo_object')，multer会自动解析multipart/form-data格式的请求，同时提取文本字段到req.body、文件到req.file，所以能正常获取数据。

解决方案 #

所有接收FormData的接口，不管是否包含文件，都需要用multer处理请求体：

1. 登录接口（无文件上传） #

使用multer的none()方法，该中间件仅解析FormData中的文本字段，不处理文件：

// 初始化multer（无需配置存储，因为不需要保存文件）
const multer = require('multer');
const upload = multer();

// 登录接口添加upload.none()中间件
app.post('/api/auth/login', upload.none(), (req, res) => {
  // 此时可正常获取req.body中的用户名、密码等字段
  const { username, password } = req.body;
  // 后续登录逻辑
});

2. 注册接口（有文件上传） #

保持现有upload.single('profile_photo_object')中间件即可，multer会同时解析文本字段和文件：

// 配置multer存储（比如存到服务器本地）
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, './uploads/'); // 确保uploads目录存在
  },
  filename: function (req, file, cb) {
    cb(null, Date.now() + '-' + file.originalname);
  }
});
const upload = multer({ storage: storage });

// 注册接口使用upload.single中间件
app.post('/api/auth/register', upload.single('profile_photo_object'), (req, res) => {
  // req.body获取注册的文本字段，req.file获取头像文件
  const { username, email, password } = req.body;
  const profilePhoto = req.file;
  // 后续注册+文件保存逻辑
});

额外注意 #

• 确保前端FormData中append的字段名和后端req.body读取的键完全一致（比如前端append('username', xxx)，后端就用req.body.username）。
• 服务器端要确保multer配置的存储目录（比如./uploads/）已创建，否则文件上传会报错。

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