使用multer处理form-data图片上传时无法获取req.body内的用户授权数据

我正在使用multer实现客户端到服务端的图片上传功能，客户端会发送form-data格式的请求。目前需要校验用户授权状态，因此在请求中额外附带了包含用户名和密码的对象，但出现了问题：服务端完全无法读取到这部分数据。
我通常使用body-parser解析请求体，常规读取请求体的方式如下：

const reqBody = JSON.parse(JSON.stringify(req.body));

其他类型的请求都能正常读取请求体，但处理form-data请求时，reqBody === {}，该如何解决？

当前使用的路由代码 #

router.post('/image_for_profile',
    cors(corsOptions),
    async(req, res) => {
        try {
            const reqBody = JSON.parse(JSON.stringify(req.body));
            console.log(reqBody) // {}

            let status;

            upload(req, res, err => {
                let error = '';

                if (err) {
                    if (err.code === 'LIMIT_FILE_SIZE') {
                        error = 'The image size should not exceed 2mb';
                    }
                    if (err.code === 'EXTENTION') {
                        error = 'The file is neither jpg, nor jpeg, nor png';
                    }
                    status = error;
                }
            });

            return res.status(200).json({
                msg: status || 'OK',
            });
        } catch (err) {
            console.log(err)
            return res.status(500).json({
                msg: config.get('msgs.statuses.500err')
            });
        }
    }
);

对应请求的参数结构可参考配套的请求截图。

核心原因 #

• body-parser 中间件原生完全不支持解析multipart/form-data格式的请求体，所有该类型请求经过body-parser处理后，req.body都会保持为空对象。
• 现有路由的执行顺序存在错误：没有将multer的解析逻辑作为路由前置中间件挂载，反而在路由业务函数内部手动调用upload方法，此时multer还未完成请求体的流解析，自然无法读取到表单附带的文本字段。

修复方案 #

1. 调整中间件挂载逻辑：将multer生成的上传处理函数作为路由的前置中间件传入，确保请求进入业务逻辑前，multer已经完成全量请求体解析——包括文件字段、非文件类文本字段都会被自动挂载到req.body和req.file上。
2. 统一错误处理时序：把原来写在upload回调里的错误判断逻辑挪到中间件层完成，避免回调嵌套导致的响应时序错乱。

修改后的参考代码：

// 初始化multer上传配置（替换原有手动调用的upload实例）
const upload = multer({
  // 保留原有文件大小限制、后缀校验等规则
});

router.post('/image_for_profile',
  cors(corsOptions),
  // 挂载multer单文件处理中间件，需和客户端传文件时的字段名保持一致
  upload.single('profile_image'),
  async (req, res) => {
    try {
      // 此时可直接读取表单附带的所有文本字段，无需额外JSON转换
      console.log(req.body);
      let status = '';

      // 统一处理上传过程的错误
      if (req.fileSizeError) {
        status = 'The image size should not exceed 2mb';
      }
      if (req.fileExtError) {
        status = 'The file is neither jpg, nor jpeg, nor png';
      }

      return res.status(200).json({
        msg: status || 'OK'
      });
    } catch (err) {
      console.log(err);
      return res.status(500).json({
        msg: config.get('msgs.statuses.500err')
      });
    }
  }
);

避坑提醒 #

• 不要在路由业务函数内部手动调用upload(req, res, callback)，这类写法会导致中间件执行时序混乱，既可能出现请求体解析不完整的问题，也容易因响应提前返回造成请求流中断。
• multer完成解析后，req.body上的文本字段都是原生字符串类型，不需要再通过JSON.parse(JSON.stringify())做冗余转换。

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