Node.js HTTP模块Headers与rawHeaders的区别及rawHeaders来源咨询

Hey there! Let's break down the difference between Headers and rawHeaders in Node.js's http module, and clear up where rawHeaders comes from since it's not super obvious in standard HTTP docs.

核心区别 #

• Headers（即request.headers/response.headers）：这是Node.js处理后的标准化头对象，所有键名都会被转为小写，并且会自动合并同名的头字段（比如多个Set-Cookie会被整合成一个数组）。举个例子，请求里的User-Agent会变成headers['user-agent']；如果有两个Set-Cookie头，headers['set-cookie']会是一个包含两个字符串的数组，方便你直接使用。
• rawHeaders：这是从TCP连接中直接读取的原始头数据，完全保留了发送方（客户端/服务器）发送时的原样——包括字段名的大小写、重复的头字段，甚至是原始的顺序。它的格式是一个数组，按[key1, value1, key2, value2, ...]的顺序存储。比如原始请求里的User-Agent: Mozilla/5.0和Accept-Language: en-US，rawHeaders就是['User-Agent', 'Mozilla/5.0', 'Accept-Language', 'en-US']；如果有两个Set-Cookie，它会是['Set-Cookie', 'cookie1=xxx', 'Set-Cookie', 'cookie2=yyy']，完全不做合并处理。

rawHeaders的来源 #

你说得没错，标准HTTP规范里确实没有"raw headers"这个术语——因为规范虽然允许头字段重复，但大多数HTTP客户端/服务端都会自动做合并、标准化处理。而Node.js的rawHeaders其实是直接来自底层HTTP解析器读取TCP流时拿到的未加工头键值对。

当Node.js的http模块接收HTTP请求或响应时，底层的解析器会逐行读取TCP传输的数据，把每个头的键和值按接收顺序直接存入rawHeaders数组，全程不做大小写转换、合并等处理。这个设计是为了满足一些特殊场景：比如有些老旧服务可能依赖头字段的大小写，或者你需要精确还原原始请求的头结构（比如做HTTP代理、日志审计），这时候rawHeaders就能派上用场。

给你看个直观的代码例子：

const http = require('http');

const server = http.createServer((req, res) => {
  console.log('✅ 标准化Headers:', req.headers);
  console.log('\n🔍 原始rawHeaders:', req.rawHeaders);
  res.end('Hello World');
});

server.listen(3000);

当你用浏览器访问http://localhost:3000，控制台输出会清晰展示两者的差异：headers是整洁的小写键值对，rawHeaders则是完全还原原始请求的数组结构。

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