NodeJS+Express使用request模块代理请求的Cookie设置问题

看起来你的代码思路是对的，但在实现细节上有几个容易踩坑的地方，导致Cookie没有正确设置到前端响应里。我来帮你梳理一下问题并给出修复方案：

核心问题分析 #

你当前的代码同时混用了req.pipe(request(...))和回调函数里的backendResponse.pipe(res)，这会导致响应头的处理冲突——流式pipe会自动把后端的响应头（包括Cookie）直接转发到前端，但如果在回调里手动设置Cookie，可能会被后续的pipe操作覆盖，或者时机不对导致设置失效。另外，你的setCookiesToResponse函数如果没有正确处理多Cookie的情况（比如用res.set而不是res.append），也会导致Cookie丢失。

修复后的代码实现 #

我们改用request模块的事件监听模式，在后端响应到达时先处理Cookie，再将响应流转发给前端，同时确保传递前端的Cookie到后端以保持会话一致性：

app.use('/api', function(req, res) {
  const options = {
    url: constants.API_COMPLETE_URL + '/api' + req.url,
    // 把前端请求的Cookie传递给后端，保证会话同步
    headers: {
      cookie: req.headers.cookie
    }
  };

  // 创建代理请求实例
  const proxyRequest = request(options);

  // 监听后端响应事件，此时响应头已就绪，还未转发给前端
  proxyRequest.on('response', function(backendResponse) {
    // 提取后端返回的Set-Cookie头（可能是一个数组）
    const backendCookies = backendResponse.headers['set-cookie'];
    if (backendCookies) {
      // 用res.append逐个添加Cookie，避免覆盖多个Cookie值
      backendCookies.forEach(cookie => {
        res.append('Set-Cookie', cookie);
      });
    }

    // 可选：复制其他必要的响应头，比如Content-Type
    if (backendResponse.headers['content-type']) {
      res.set('Content-Type', backendResponse.headers['content-type']);
    }
  });

  // 处理代理请求的错误
  proxyRequest.on('error', function(err) {
    res.status(501).send(`代理请求失败：${err.message}`);
  });

  // 把前端请求流到代理请求，再把代理响应流到前端
  req.pipe(proxyRequest).pipe(res);
});

关键细节说明 #

1. 避免流式和回调混用：通过监听response事件来处理Cookie，这个时机是在后端响应头已经接收，但响应体还未开始转发的时候，确保Cookie设置不会被覆盖。
2. 用res.append设置Cookie：Set-Cookie响应头支持多个值，res.append会在现有头的基础上添加新值，而res.set会覆盖原有值，这是很多人踩坑的点。
3. 传递前端Cookie到后端：如果后端需要识别用户会话，必须把前端请求里的cookie头传递过去，否则代理请求相当于一个新的未登录会话。

额外建议：迁移到维护中的HTTP库 #

注意request模块已经被官方标记为废弃状态，不再接受新特性和bug修复，建议后续迁移到axios、node-fetch或got这些维护中的库。这里给你一个用node-fetch实现的版本作为参考：

const fetch = require('node-fetch');

app.use('/api', async function(req, res) {
  try {
    const targetUrl = constants.API_COMPLETE_URL + '/api' + req.url;
    const fetchOptions = {
      method: req.method,
      // 复制前端请求的头，替换host为后端服务的host
      headers: {
        ...req.headers,
        host: new URL(constants.API_COMPLETE_URL).host
      },
      // 处理请求体（GET/HEAD请求不需要）
      body: req.method !== 'GET' && req.method !== 'HEAD' ? req.body : undefined,
      credentials: 'include'
    };

    const backendResponse = await fetch(targetUrl, fetchOptions);

    // 处理Cookie
    const backendCookies = backendResponse.headers.raw()['set-cookie'];
    if (backendCookies) {
      backendCookies.forEach(cookie => res.append('Set-Cookie', cookie));
    }

    // 设置响应状态和其他头
    res.status(backendResponse.status);
    backendResponse.headers.forEach((value, key) => {
      if (key !== 'set-cookie') { // 跳过已处理的Cookie头
        res.set(key, value);
      }
    });

    // 流式返回响应体
    backendResponse.body.pipe(res);
  } catch (err) {
    res.status(501).send(`代理请求失败：${err.message}`);
  }
});

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