http-proxy-middleware通过on.proxyReq添加自定义请求头不生效问题

自定义头设置不生效是http-proxy-middleware的流处理时序导致的：

• 带请求体的请求（POST/PUT/PATCH等）、或是请求已经被前置中间件（比如你代码里的auth鉴权中间件、express.json()这类body解析中间件）读取过body的场景下，代理会在你注册的proxyReq回调执行前，就把请求头序列化写入底层TCP流。这时候再调用proxyReq.setHeader()修改的头，根本不会被包含在最终发出的代理请求里。
• 你代码里直接拼接字符串打印proxyReq对象也没法验证头是否设置成功，它是Node.js原生的ClientRequest流对象，直接转字符串输出拿不到实际的头信息。

方案1：固定头直接用配置项声明（最稳定） #

如果头值不需要动态计算，直接用代理配置自带的headers字段注入，这个字段会在代理请求头初始化阶段就加载，完全不受流时序影响：

app.use('/info', auth, createProxyMiddleware({
    target: process.env.BASE_API_URL,
    changeOrigin: false,
    // 直接在这里声明要加的自定义头
    headers: {
        'x-auth-user': 'b05ff410-fbba-11ec-bfce-ddefb9f79237'
    },
    on: {
        proxyRes: (proxyRes, req, res) => {
            console.log(`On Proxy Response, status code: ${proxyRes.statusCode}`);
        },
        error: (err, req, res) => {
            console.log(`On Proxy Error: ${err.message}`);
        },
    },
}));

方案2：动态设置头的正确写法 #

如果头值需要从当前请求上下文动态获取（比如从req会话里取实际登录用户的auth ID，而非写死固定值），注意不要在proxyReq钩子里写异步逻辑——等异步回调执行时请求头早就已经发送完成，再设头完全无效。正确写法是把设头逻辑放在钩子最前面同步执行，同时处理好被前置中间件解析过的body回写：

app.use('/info', auth, createProxyMiddleware({
    target: process.env.BASE_API_URL,
    changeOrigin: false,
    on: {
        proxyReq: (proxyReq, req, res) => {
            // 设头逻辑必须放在所有流操作的最前面，同步执行
            proxyReq.setHeader('x-auth-user', req.user?.authId || 'b05ff410-fbba-11ec-bfce-ddefb9f79237');
            
            // 如果前置中间件已经解析过body，必须把解析后的body重新写回代理请求
            if (req.body) {
                const bodyData = JSON.stringify(req.body);
                // 同步更新content-length头，避免请求长度不匹配报错
                proxyReq.setHeader('Content-Length', Buffer.byteLength(bodyData));
                proxyReq.write(bodyData);
                proxyReq.end();
            }
        },
        proxyRes: (proxyRes, req, res) => {
            console.log(`On Proxy Response, status code: ${proxyRes.statusCode}`);
        },
        error: (err, req, res) => {
            console.log(`On Proxy Error: ${err.message}`);
        },
    },
}));

要确认头是否真的注入成功，可以在设头逻辑执行后，调用proxyReq.getHeader('x-auth-user')打印返回值验证，不要直接打印整个proxyReq流对象。

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