侧边栏壁纸
博主头像
一笑痕

人生若只如初见,
是可喜亦或者是可悲?

  • 累计撰写 285 篇文章
  • 累计收到 7 条评论

请求头没收完,Node 返回 408 后请求事件不会触发

2026-11-19 / 0 评论 / 0 阅读

请求头没收完,Node 返回 408 后请求事件不会触发

一个请求只送来 GET /partial 和半截请求头,服务端没有拿到可供路由的完整请求,却仍要决定连接怎么结束。Node 的 headersTimeout 到期后会让解析器进入错误路径,应用层的 request 事件不一定有机会出现。把超时监控只放在路由回调里,这一类连接就会漏掉。

本机脚本 tools/verify-node-headers-timeout.mjs 用 net 建立回环 TCP 连接,发送不完整的 HTTP 头。服务绑定 127.0.0.1,没有访问网络。Node 是 v26.8.1,测试把 server.headersTimeout 设为 500 毫秒,把 connectionsCheckingInterval 设为 100 毫秒。这个短值只为让复现快些,不是生产推荐配置。

runtime: v26.8.1
headersTimeout: 500
connectionsCheckingInterval: 100
clientError: ERR_HTTP_REQUEST_TIMEOUT
response: "HTTP/1.1 408 Request Timeout"
assertion: PASS (incomplete headers receive 408 before request event)

日志里没有 request event: /partial。错误先由 clientError 收到,代码随后向仍可写的 socket 回了 408。脚本里的处理器把 clientError 记下,也避免把不完整请求送进业务逻辑。若服务没有注册自己的处理器,Node 会按默认行为处理这类解析错误;应用若接管了事件,就要负责安全地结束或销毁 socket,不能只记录一条日志然后让连接挂着。

超时发生在解析头部时

HTTP 请求要等请求行和所有头部完整,Node 才会触发服务器的 request 事件。测试发送的最后一个字段停在冒号后面,解析器等不到字段值和头部终止符,因此 handler 没有机会记录路径或返回常规业务响应。到达头部接收期限后,Node 发出 clientError,错误码是 ERR_HTTP_REQUEST_TIMEOUT。

错误码虽然有 timeout 字样,接入点仍是 clientError,不是 server.on('timeout')。这两种事件不能按名字混成一个计时器。测试没有添加 request 监听器里的超时逻辑,仍然观察到 408;说明只依赖路由层的请求耗时统计,不会覆盖头部尚未解析完成的连接。

代码示例展示这一层的基本边界:

server.on('clientError', (err, socket) => {
  if (socket.writable) {
    socket.end('HTTP/1.1 408 Request Timeout\\r\\nConnection: close\\r\\n\\r\\n');
  }
});

手动写响应行时,状态行和连接关闭语义都由服务代码负责。若 socket 已不可写,应停止写入并清理连接。错误类型不只包含超时,语法错误也可能走 clientError,因此示例不适合把所有错误都回复成 408。生产实现要按 err.code 区分要返回的状态,并限制错误日志里的输入内容,避免把任意请求头直接写入日志。

检查间隔会影响观测时刻

headersTimeout 是允许接收完整头部的时间上限,connectionsCheckingInterval 则控制 Node 多久检查一次超时连接。本次把检查间隔调到 100 毫秒,所以超时附近的关闭动作不会精确落在 500 毫秒那一刻。这个数值是检查节奏,不是应用获得的精确截止时间。不能据一条测试日志推断线上每条连接都恰好在配置值到点时立刻收到响应。

测试里两项都显式设置,目的是把判断条件和观测节奏分开。生产中应结合实际请求头大小评估配置,不宜为了尽早拦截而把头部时间设得过短。慢客户端可能确实在传输较大的合法头部,配置过紧会把有效请求也拒掉;反过来,期限太宽会让大量未完成连接占住资源。

连接检查间隔也不是对业务请求执行时间的上限。请求头完整以后,才会进入应用处理;数据库等待或业务运算另有自己的超时策略。把 headersTimeout 当作整个请求的总时限,会留下一个未经覆盖的阶段。对一个已经进入路由的请求,要由应用另外管理处理期限和取消行为。

代理前后看到的不是同一段连接

这个复现让 TCP 客户端直接连 Node。生产环境若有反向代理,代理可能先接收并缓冲完整请求头,再用另一条连接访问 Node。此时客户端的慢速发送和后端看到的到达节奏并不相同,Node 的配置保护的是 Node 所接收的那条连接,不能直接代表浏览器到代理之间的等待时间。

因此,排查时要先问超时发生在哪一跳。Node 的 clientError 能证明后端解析器拒绝了这条连接,却不能单独说明原始客户端如何发送,也不能证明代理是否已经给客户端回过响应。代理自己的头部超时也需要核对,Node 侧的 clientError 不能说明客户端到代理之间等待了多久。

我会把 clientError 纳入服务级日志,同时让路由层继续记录已解析请求的处理耗时。前者能看到尚未进入 handler 的解析失败,后者才适合诊断业务慢请求。两类事件要分开统计,否则 408 数字会和应用执行超时混在一起。若服务要自行生成错误响应,先按错误码判断,再确认 socket 仍可写;只需用 Node 默认处理时,就别为了记录方便重复写一份不完整的 HTTP 响应逻辑。

    🤞 分享