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,不要自己用字符串切割问号。

js
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 启动服务。

bash
node request-info.js

预期输出:

text
Listening on http://127.0.0.1:3001

保持终端 A 运行,在终端 B 发送一个带查询参数和自定义请求头的请求。

bash
curl -H 'X-Trace-Id: demo-001' 'http://127.0.0.1:3001/items?limit=2'

预期输出:

json
{"ok":true}

与此同时,终端 A 会追加类似下面的日志:

text
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 层,后续写路由、访问日志和鉴权判断就有了可靠输入。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取请求信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通