使用Multer 2.0.0-rc.1时req.file与req.body无法正常获取

你遇到的req.body为空对象、req.file为null的情况，通常是以下几个原因导致的，对应解决方案如下：

1. 前端请求未使用正确的Content-Type #

multer仅能解析multipart/form-data类型的请求，前端必须满足这个条件：

• 若用HTML表单提交，需添加enctype="multipart/form-data"属性：

<form action="/register" method="POST" enctype="multipart/form-data">
  <input type="file" name="avatar" />
  <input type="text" name="username" />
  <button type="submit">提交</button>
</form>

• 若用AJAX/Fetch提交，需使用FormData对象（浏览器会自动设置正确的Content-Type）：

const formData = new FormData();
formData.append('avatar', document.getElementById('avatarInput').files[0]);
formData.append('username', 'test_user');

fetch('/register', {
  method: 'POST',
  body: formData
});

2. 文件字段名与multer配置不匹配 #

你在multer中配置的是.single("avatar")，意味着前端上传的文件字段名必须严格等于avatar，如果前端字段名是file或其他名称，multer会识别不到文件，导致req.file为null。

3. multer候选版本存在兼容性问题 #

你使用的multer@2.0.0-rc.1是候选发布版，可能存在未修复的bug。建议降级到稳定的长期支持版：

npm uninstall multer
npm install multer@1.4.5-lts.1

4. 中间件顺序冲突 #

确保你的Express应用中，没有在multer中间件之前使用express.json()或express.urlencoded()来处理请求（这两个中间件无法解析multipart/form-data），同时保证upload中间件直接挂载在目标路由上，没有被其他中间件拦截。

可以临时添加调试代码，确认multer是否正常执行：

// Userroute.js
router.route("/register").post(upload, (req, res, next) => {
  console.log("multer解析结果：", req.file, req.body);
  next();
}, registerUser);

如果以上方法都无法解决，检查前端请求是否真的携带了文件和表单数据，可以通过浏览器开发者工具的Network面板查看请求的FormData内容。

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