如何用http-proxy-middleware在Firebase中代理FormData与JWT令牌？

问题背景 #

在Firebase中使用http-proxy-middleware搭建代理时，GET请求正常，但POST请求存在如下问题：

• 添加onProxyReq后可正常转发JSON格式请求体，但FormData格式请求体无法传递
• 修改Content-Type为multipart/form-data无效果
• 需要同时实现请求头中JWT令牌和请求体中FormData的代理转发

核心问题分析 #

1. 原代码中bodyParser.urlencoded会解析application/x-www-form-urlencoded类型的请求，但无法处理multipart/form-data（即FormData），反而会破坏原始请求体的结构
2. 自定义的restream函数强制将请求头设置为application/json，覆盖了FormData的原始Content-Type，导致后端无法识别请求体格式

最优实现方案 #

关键调整点 #

• 移除bodyParser.urlencoded，避免干扰multipart请求的处理
• 使用http-proxy-middleware内置的fixRequestBody辅助函数，自动适配JSON、FormData等多种请求体类型
• 保留原始请求头（包括JWT令牌），无需额外手动复制（代理默认会转发请求头，若需确保可显式处理）
• 不强制修改Content-Type，沿用客户端发送的原始请求头

修改后的完整代码 #

const functions = require("firebase-functions");
const express = require("express");
const { createProxyMiddleware, fixRequestBody } = require("http-proxy-middleware");

const app = express();

// 自定义代理请求处理逻辑，兼顾JWT转发与请求体适配
const handleProxyReq = (proxyReq, req, res, options) => {
  // 若需要显式确保JWT令牌转发（可选，默认代理会转发所有请求头）
  // if (req.headers.authorization) {
  //   proxyReq.setHeader('Authorization', req.headers.authorization);
  // }
  
  // 使用fixRequestBody自动处理JSON、FormData等多种请求体类型
  fixRequestBody(proxyReq, req, res);
};

app.use(
  "/",
  createProxyMiddleware({
    target: "http://IPADDRESS:8080/api",
    changeOrigin: true,
    onProxyReq: handleProxyReq,
    bodyParser: false, // 禁用内置bodyParser，由fixRequestBody处理
  })
);

exports.api = functions.https.onRequest(app);

代码说明 #

• fixRequestBody：http-proxy-middleware提供的工具函数，自动识别请求体类型并完成正确的转发，无需手动处理不同格式的请求体序列化
• bodyParser: false：禁用代理内置的body解析，避免与fixRequestBody冲突
• JWT令牌转发：默认情况下，代理会自动转发所有请求头，包括Authorization（JWT令牌通常存于此），若需特殊处理可在handleProxyReq中显式设置
• 保留原始Content-Type：不再强制设置为application/json，后端可根据客户端发送的请求头正确解析FormData或JSON

内容的提问来源于stack exchange，提问作者Yusuf Berki YAZICIOGLU