You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Express服务器中Multer获取req.files与req.body均为undefined问题

问题排查与解决方案

核心问题1:后端中间件调用完全错误

你服务层里的(upload.any(), (req, res) => {})用了逗号运算符,这会直接跳过upload.any()的执行,只返回后面的处理函数——等于multer中间件根本没生效,自然拿不到任何数据。

修复方式

把multer中间件正确挂载到路由上,两种写法任选:

写法1:路由中直接挂载

const upload = require('./multerInstance');

// 在路由文件里这样写
router.post('/register', upload.any(), (req, res) => {
  console.log(req.files);
  console.log(req.body);
  // 后续业务逻辑
});

写法2:抽离服务函数时的正确用法

// 服务层代码
module.exports.publicUsersService = (req, res) => {
  console.log(req.files);
  console.log(req.body);
};

// 路由文件中
const upload = require('./multerInstance');
const { publicUsersService } = require('./service');

router.post('/register', upload.any(), publicUsersService);

核心问题2:前端Axios手动设置Content-Type坑

用FormData提交时,绝对不要手动写"Content-Type": "multipart/form-data"。Axios会自动生成带boundary的正确请求头,手动设置会丢失这个关键参数,导致后端完全解析不了表单。

修复后的Axios代码

await axios
  .post(
    status === "register"
      ? "api/v1/publicUsers/register"
      : "api/v1/publicUsers/login",
    formData,
    {
      // 删掉手动设置的Content-Type
      onUploadProgress: (data) => {
        setProgress(Math.round((100 * data.loaded) / data.total));
        console.log(progress);
      },
      withCredentials: true,
    }
  )

额外必查:前端FormData是否正确构造

确认你的handleSubmit函数里,真的把表单数据塞进FormData了,比如:

const handleSubmit = (e) => {
  e.preventDefault();
  const formData = new FormData();
  formData.append('email', email); // email是你状态里存的邮箱值
  formData.append('password', password); // password是状态里存的密码值
  if (status === 'register' && file) {
    formData.append('file', file); // file是状态里存的文件对象
  }
  // 然后调用Axios提交
};

次要检查:Multer存储路径问题

确保../public/uploads/目录存在,且Node进程有读写权限,建议改成绝对路径避免相对路径坑:

const path = require('path');

const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    // 用绝对路径确保目录正确
    const uploadPath = path.join(__dirname, '../public/uploads/');
    cb(null, uploadPath);
  },
  filename: function (req, file, cb) {
    cb(null, file.originalname);
  },
});

按上面的步骤改完,后端就能正常拿到req.files和req.body的数据了。

内容的提问来源于stack exchange,提问作者Tanim Istiak

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.09 20:18:17