Node.js / 系统课时
读取请求信息
读取请求信息
HTTP 服务器收到请求后,路由和日志判断都依赖请求信息。这一课会读取方法、路径、查询参数、请求头以及 TCP 连接地址,并用一次 curl 请求核对每个值来自哪里。
学习目标
- 读取
req.method、req.url和req.headers。 - 用
URL正确拆分路径与查询参数。 - 从
req.socket获取客户端与服务端连接信息,并识别代理场景的边界。
先分清请求对象里的信息
Node.js HTTP 服务端的 req 是一个 IncomingMessage。最常用的入口可以按下面四类记:方法看 req.method,原始请求目标看 req.url,请求头看 req.headers,当前 TCP 连接看 req.socket。
| 目标信息 | 读取方式 | 本课请求中的示例 |
|---|---|---|
| HTTP 方法 | req.method |
GET |
| 原始路径与查询串 | req.url |
/items?limit=2 |
| 主机请求头 | req.headers.host |
127.0.0.1:3001 |
| 自定义请求头 | req.headers['x-trace-id'] |
demo-001 |
| 对端 IP 与端口 | req.socket.remoteAddress、remotePort |
127.0.0.1:<PORT> |
| 本地 IP 与端口 | req.socket.localAddress、localPort |
127.0.0.1:3001 |
req.headers 中的字段名会以小写形式访问,所以示例使用 x-trace-id。如果确实要观察收到时的原始大小写与顺序,可查看 req.rawHeaders;业务判断通常使用 req.headers 更方便。
记录一次完整请求
新建 request-info.js。req.url 可能同时包含路径和查询串,因此先用 new URL() 拆分,再读取 pathname 和 searchParams,不要自己用字符串切割问号。
const http = require('http');
const host = '127.0.0.1';
const port = 3001;
const server = http.createServer((req, res) => {
const url = new URL(req.url, 'http://localhost');
console.log('method=' + req.method);
console.log('pathname=' + url.pathname);
console.log('limit=' + (url.searchParams.get('limit') ?? ''));
console.log('host=' + (req.headers.host ?? ''));
console.log('trace=' + (req.headers['x-trace-id'] ?? ''));
console.log('remote=' + req.socket.remoteAddress + ':' + req.socket.remotePort);
console.log('local=' + req.socket.localAddress + ':' + req.socket.localPort);
res.setHeader('Content-Type', 'application/json; charset=utf-8');
res.end(JSON.stringify({ ok: true }));
});
server.listen(port, host, () => {
console.log('Listening on http://' + host + ':' + port);
});这段代码只读取请求信息,不修改请求对象。new URL(req.url, 'http://localhost') 中的基准地址用于解析相对请求目标;本例真正关心的是 pathname 与查询参数,因此不依赖这个基准地址的主机名。
用 curl 对照每个字段
先在终端 A 启动服务。
node request-info.js预期输出:
Listening on http://127.0.0.1:3001保持终端 A 运行,在终端 B 发送一个带查询参数和自定义请求头的请求。
curl -H 'X-Trace-Id: demo-001' 'http://127.0.0.1:3001/items?limit=2'预期输出:
{"ok":true}与此同时,终端 A 会追加类似下面的日志:
method=GET
pathname=/items
limit=2
host=127.0.0.1:3001
trace=demo-001
remote=127.0.0.1:<PORT>
local=127.0.0.1:3001其中 <PORT> 是客户端这次 TCP 连接临时分配的源端口,实际数字每次可能不同。这个输出也说明 req.url 中的 /items?limit=2 经过 URL 解析后,路径是 /items,查询参数 limit 的值是 2。
别把代理请求当成直连请求
req.socket.remoteAddress 表示与 Node.js 直接建立 TCP 连接的对端。如果前面还有 Nginx、负载均衡器或云代理,这个地址通常会变成代理服务器地址,而不一定是最终用户 IP。
实际项目若要读取 X-Forwarded-For 或类似代理头,必须先明确哪些代理是可信的,再按部署规则解析;不要因为请求头里出现一个 IP 就直接当作真实客户端地址。直连开发环境下,则以 req.socket.remoteAddress 验证连接来源最清楚。
请求信息的最小验收方法是:改一次方法、路径、查询参数或请求头,再确认日志中只有对应字段变化。只要能稳定解释每个值来自 HTTP 层还是 TCP 层,后续写路由、访问日志和鉴权判断就有了可靠输入。