setHeader与writeHead是否存在关联？Node.js HTTP头问题咨询

核心原因在于Node.js HTTP响应对象对两种头部设置方式的内部处理逻辑不同：

• res.setHeader()的机制：
  这个方法会把你设置的头部存储到响应对象的内部头缓存区，res.getHeaders()就是从这个缓存区读取数据的。哪怕之后调用res.writeHead()，writeHead()里的头部也会合并到这个缓存区中，所以此时调用res.getHeaders()能拿到所有头部信息。

• res.writeHead()的单独调用机制：
  如果你没调用过res.setHeader()，直接用res.writeHead()设置头部，它会直接把HTTP状态行和头部写入到响应流里，不会把这些头部数据存入res.getHeaders()读取的缓存区。这就导致你调用res.getHeaders()时得到的是空对象——缓存区里根本没数据。

解决办法 #

如果想通过res.getHeaders()获取writeHead()设置的头部，有两种简单方式：

1. 先调用一次res.setHeader()（哪怕设置一个无关的空头部），初始化内部缓存区，之后writeHead()的头部会自动合并到缓存里：

const http = require("http");

const server = http.createServer((req, res) => {
  // 初始化缓存区
  res.setHeader("X-Temp", "");
  res.writeHead(200, {
    "Content-Type": "text/plain",
    Authorization: "Header 123456",
  });
  res.write('Yes....')

  res.end("Hello World..");
  console.log(JSON.stringify(res.getHeaders())); // 输出包含所有头部的对象
});

server.listen(3000, "localhost", () => {
  console.log("Server Running.....");
});

2. 优先使用res.setHeader()设置所有头部，最后由res.end()自动发送（不需要手动调用writeHead()），这种方式下res.getHeaders()始终能拿到完整头部：

const http = require("http");

const server = http.createServer((req, res) => {
  res.setHeader("Content-Type", "text/plain");
  res.setHeader("Authorization", "Header 123456");
  res.write('Yes....')

  res.end("Hello World..");
  console.log(JSON.stringify(res.getHeaders())); // 正常输出所有头部
});

server.listen(3000, "localhost", () => {
  console.log("Server Running.....");
});

补充说明 #

Node.js的这种设计是为了区分两种头部操作场景：

• setHeader()适合需要逐步添加、修改头部的场景，所有操作都先在缓存里完成，最后统一发送。
• writeHead()适合确定所有头部后直接发送的场景，它会立即写入响应流，无法再修改头部（调用后setHeader()会失效）。

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