Node.js通过http/https模块操作HTTP头，使用request.headers读取请求头，response.setHeader或res.writeHead设置响应头，注意在发送响应前完成头设置，避免错误；可通过中间件统一处理头信息，如CORS、认证等，结合cookie模块处理Cookie，利用Accept头实现内容协商，确保头字段格式正确、值合法，提升应用安全性与兼容性。
在Node.js中，你可以通过
http或
https模块来操作HTTP头，无论是设置请求头还是响应头，都相当直接。核心在于理解
request和
response对象，它们分别代表客户端请求和服务器响应。
解决方案
在Node.js中，操作HTTP头主要涉及两个方面：处理客户端请求的头信息以及设置服务器响应的头信息。
处理客户端请求头信息
当Node.js服务器接收到客户端的请求时，请求头信息会包含在
request对象中。你可以通过
request.headers属性访问这些头信息，它是一个JavaScript对象，包含了所有请求头字段和对应的值。
const http = require('http');
const server = http.createServer((req, res) => {
console.log('请求头:', req.headers); // 打印所有请求头
const userAgent = req.headers['user-agent']; // 获取User-Agent
console.log('User-Agent:', userAgent);
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello, World!');
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});这段代码演示了如何访问和打印请求头，以及如何获取特定的请求头字段（例如
User-Agent）。
设置服务器响应头信息
在服务器端，你需要使用
response对象来设置响应头。有两种主要的方式：
res.setHeader()和
res.writeHead()。
res.setHeader(name, value)
: 用于设置单个响应头。可以多次调用来设置多个头。res.writeHead(statusCode, [reasonPhrase], [headers])
: 用于设置HTTP状态码和响应头。通常在发送响应体之前调用。
const http = require('http');
const server = http.createServer((req, res) => {
res.setHeader('Content-Type', 'application/json');
res.setHeader('X-Custom-Header', 'My Custom Value');
const responseData = { message: 'Hello, World!' };
res.writeHead(200);
res.end(JSON.stringify(responseData));
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，我们使用
res.setHeader()设置了
Content-Type和自定义的
X-Custom-Header。然后，使用
res.writeHead()设置了状态码200。注意，
res.writeHead()也可以接受一个包含头信息的对象作为第三个参数，这允许你一次性设置多个头。
一些需要注意的点
-
大小写不敏感: HTTP头字段名是不区分大小写的，但通常建议使用首字母大写的形式，例如
Content-Type
。 - 重复的头: 如果多次设置同一个头，行为取决于具体的头。有些头会覆盖之前的值，有些头会合并多个值。
-
顺序: 头发送的顺序很重要，特别是对于一些特殊的头，例如
Content-Length
。 - 状态码: 确保设置正确的HTTP状态码，这对于客户端正确处理响应至关重要。
如何处理Node.js中常见的HTTP头相关错误？
处理HTTP头时，一些常见的错误包括：尝试在发送响应体后修改头、设置了无效的头值、或者头信息格式不正确。
-
在发送响应体后修改头: 一旦你调用了
res.end()
或res.write()
发送了响应体，就不能再修改头了。Node.js会抛出一个错误。const http = require('http'); const server = http.createServer((req, res) => { res.writeHead(200, {'Content-Type': 'text/plain'}); res.end('Hello, World!'); // 尝试在res.end()之后设置头，会报错 // res.setHeader('X-Custom-Header', 'My Custom Value'); // 错误：Cannot set headers after they are sent to the client }); server.listen(3000, () => { console.log('Server running on port 3000'); });解决方法是在发送响应体之前设置所有需要的头。
-
设置无效的头值: 某些头有特定的值格式要求。例如，
Content-Length
必须是一个整数。如果设置了无效的值，可能会导致客户端无法正确解析响应。res.setHeader('Content-Length', 'abc'); // 错误：Content-Length必须是整数确保按照HTTP规范设置正确的头值。
-
头信息格式不正确: 头字段名和值之间应该用冒号分隔，并且遵循HTTP协议的格式要求。不正确的格式可能导致客户端无法解析头信息。
res.setHeader('Content-Type: text/plain'); // 错误：格式不正确正确的写法是
res.setHeader('Content-Type', 'text/plain'); -
CORS错误: 跨域资源共享（CORS）错误是常见的HTTP头相关问题。当客户端从一个域请求另一个域的资源时，浏览器会进行CORS检查。服务器需要设置适当的
Access-Control-Allow-Origin
头来允许跨域请求。res.setHeader('Access-Control-Allow-Origin', '*'); // 允许所有域更安全的做法是只允许特定的域：
res.setHeader('Access-Control-Allow-Origin', 'https://example.com'); // 只允许example.com
如何使用Node.js处理Cookie？
Cookie是存储在客户端浏览器中的小型文本文件，用于在客户端和服务器之间传递状态信息。Node.js提供了多种方式来处理Cookie，包括读取请求中的Cookie和设置响应中的Cookie。
读取请求中的Cookie
请求中的Cookie信息包含在
request.headers.cookie字段中。这个字段是一个字符串，包含了所有Cookie的键值对，用分号和空格分隔。你需要解析这个字符串来获取单个Cookie的值。
const http = require('http');
const cookie = require('cookie');
const server = http.createServer((req, res) => {
const cookies = cookie.parse(req.headers.cookie || '');
console.log('Cookies:', cookies);
const myCookie = cookies.myCookie; // 获取名为myCookie的Cookie
console.log('myCookie:', myCookie);
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello, World!');
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，我们使用了
cookie模块（需要通过
npm install cookie安装）来解析
request.headers.cookie字符串。
cookie.parse()函数将Cookie字符串转换为一个JavaScript对象，方便我们访问单个Cookie的值。
设置响应中的Cookie
要设置响应中的Cookie，你需要使用
Set-Cookie头。你可以使用
res.setHeader()来设置这个头。
const http = require('http');
const server = http.createServer((req, res) => {
res.setHeader('Set-Cookie', 'myCookie=myValue; Path=/; HttpOnly'); // 设置Cookie
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello, World!');
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，我们设置了一个名为
myCookie的Cookie，值为
myValue。
Path=/表示这个Cookie对整个域名有效。
HttpOnly表示这个Cookie只能通过HTTP访问，不能通过JavaScript访问，这有助于防止XSS攻击。
Cookie选项
Set-Cookie头支持多个选项，用于控制Cookie的行为：
Path
: 指定Cookie的有效路径。Domain
: 指定Cookie的有效域名。Expires
: 指定Cookie的过期时间。Max-Age
: 指定Cookie的有效期（秒）。Secure
: 指定Cookie只能通过HTTPS连接发送。HttpOnly
: 指定Cookie只能通过HTTP访问。SameSite
: 指定Cookie的跨站行为（Strict
,Lax
,None
）。
你可以通过在
Set-Cookie头中添加这些选项来更精细地控制Cookie的行为。例如：
res.setHeader('Set-Cookie', [
'myCookie=myValue; Path=/; HttpOnly',
'anotherCookie=anotherValue; Domain=example.com; Max-Age=3600'
]);这段代码设置了两个Cookie，一个设置了
HttpOnly选项，另一个设置了
Domain和
Max-Age选项。
如何在Node.js中使用HTTP头进行内容协商？
内容协商是一种机制，允许客户端和服务器就响应的最佳表示形式达成一致。客户端通过
Accept、
Accept-Language、
Accept-Encoding等请求头来表达其偏好，服务器根据这些偏好选择最合适的响应内容。
处理Accept
头
Accept头指定客户端可以接受的内容类型。服务器可以解析这个头，并根据客户端的偏好返回不同类型的响应。
const http = require('http');
const server = http.createServer((req, res) => {
const accept = req.headers['accept'];
if (accept.includes('application/json')) {
res.setHeader('Content-Type', 'application/json');
const responseData = { message: 'Hello, World!' };
res.end(JSON.stringify(responseData));
} else if (accept.includes('text/html')) {
res.setHeader('Content-Type', 'text/html');
res.end('<h1>Hello, World!</h1>');
} else {
res.setHeader('Content-Type', 'text/plain');
res.end('Hello, World!');
}
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，服务器根据
Accept头的值返回不同类型的响应。如果客户端接受
application/json，则返回JSON格式的响应；如果客户端接受
text/html，则返回HTML格式的响应；否则，返回纯文本格式的响应。
处理Accept-Language
头
Accept-Language头指定客户端可以接受的语言。服务器可以解析这个头，并根据客户端的偏好返回不同语言的响应。
const http = require('http');
const server = http.createServer((req, res) => {
const acceptLanguage = req.headers['accept-language'];
let message = 'Hello, World!';
if (acceptLanguage.includes('zh')) {
message = '你好，世界！';
} else if (acceptLanguage.includes('fr')) {
message = 'Bonjour, le monde!';
}
res.setHeader('Content-Type', 'text/plain; charset=utf-8');
res.end(message);
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，服务器根据
Accept-Language头的值返回不同语言的问候语。
处理Accept-Encoding
头
Accept-Encoding头指定客户端可以接受的编码方式（例如gzip、deflate）。服务器可以根据这个头选择合适的编码方式来压缩响应，从而减少传输大小。
const http = require('http');
const zlib = require('zlib');
const server = http.createServer((req, res) => {
const acceptEncoding = req.headers['accept-encoding'];
let raw = 'Hello, World!'.repeat(1000); // 创建一个较大的字符串
if (acceptEncoding && acceptEncoding.includes('gzip')) {
zlib.gzip(raw, (err, compressed) => {
if (err) {
console.error(err);
res.writeHead(500);
res.end('Error compressing response');
return;
}
res.setHeader('Content-Encoding', 'gzip');
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end(compressed);
});
} else {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end(raw);
}
});
server.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，服务器首先检查
Accept-Encoding头是否包含
gzip。如果包含，则使用
zlib.gzip()函数压缩响应，并设置
Content-Encoding头为
gzip。否则，直接返回未压缩的响应。
使用第三方库
一些第三方库可以简化内容协商的处理，例如
negotiator。这些库可以解析
Accept、
Accept-Language、
Accept-Encoding等头，并根据客户端的偏好选择最佳的响应。
如何使用中间件来处理HTTP头？
中间件是在请求到达最终路由处理程序之前执行的函数。它们可以用于处理各种任务，包括修改请求或响应头。在Express.js等框架中，中间件是处理HTTP头的常用方法。
const express = require('express');
const app = express();
// 中间件示例：设置全局的X-Powered-By头
app.use((req, res, next) => {
res.setHeader('X-Powered-By', 'Node.js');
next(); // 调用next()传递控制权给下一个中间件或路由处理程序
});
// 中间件示例：处理CORS
app.use((req, res, next) => {
res.setHeader('Access-Control-Allow-Origin', '*');
res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE');
res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
next();
});
// 路由处理程序
app.get('/', (req, res) => {
res.send('Hello, World!');
});
app.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，我们定义了两个中间件。第一个中间件设置了全局的
X-Powered-By头，用于标识服务器使用的技术。第二个中间件处理了CORS，允许来自任何域的跨域请求。
使用中间件处理请求头
中间件也可以用于处理请求头。例如，你可以创建一个中间件来检查请求头中是否包含特定的认证信息。
const express = require('express');
const app = express();
// 中间件示例：检查认证信息
app.use((req, res, next) => {
const authHeader = req.headers['authorization'];
if (!authHeader) {
return res.status(401).send('Unauthorized');
}
// 在这里验证authHeader的值
// 例如，检查是否与预期的令牌匹配
next();
});
// 路由处理程序
app.get('/protected', (req, res) => {
res.send('Protected Resource');
});
app.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，中间件检查请求头中是否包含
Authorization头。如果不包含，则返回401 Unauthorized错误。如果包含，则可以进一步验证
Authorization头的值，例如检查是否与预期的令牌匹配。
使用express.json()
和express.urlencoded()
中间件
express.json()和
express.urlencoded()是Express.js内置的中间件，用于解析请求体中的JSON和URL编码的数据。它们会自动设置
Content-Type头为
application/json或
application/x-www-form-urlencoded。
const express = require('express');
const app = express();
app.use(express.json()); // 解析JSON请求体
app.use(express.urlencoded({ extended: true })); // 解析URL编码的请求体
app.post('/data', (req, res) => {
console.log('请求体:', req.body);
res.send('Data received');
});
app.listen(3000, () => {
console.log('Server running on port 3000');
});在这个例子中，
express.json()和
express.urlencoded()中间件会自动解析请求体中的数据，并将解析后的数据存储在
req.body对象中。
总而言之，Node.js中操作HTTP头是一个直接但多面的任务，涉及到请求和响应的处理。理解HTTP头的工作原理，以及如何正确地设置和处理它们，对于构建健壮和安全的Web应用程序至关重要。使用中间件可以更方便地处理HTTP头，并提高代码的可维护性。
