Node.js 16.19.0在Windows与GKE Ubuntu环境下HTTP请求超时差异问题

核心原因：系统TCP栈的默认超时配置差异 #

Node.js的http.request在未手动设置超时的情况下，连接超时完全由操作系统的TCP协议栈控制，而非Node.js本身。Windows和Linux（Ubuntu）的TCP连接重试策略存在显著区别：

• Windows系统：默认的SYN包重传次数和间隔较短，总超时时间约为20秒。当目标IP无响应时，TCP层会在20秒内放弃重试，触发连接关闭，进而触发Node.js的close事件。
• GKE Ubuntu容器：Linux内核默认通过tcp_retries2参数控制TCP连接的重传次数（默认值为15），结合指数退避的重传间隔，总超时时间约为130秒。只有当TCP层完成所有重试后，才会触发Node.js的close事件。

关于timeout事件触发的差异 #

Node.js的timeout事件属于应用层超时，与TCP层的底层超时是独立的两个机制：

• 在Windows系统中，TCP层在20秒就已经断开连接并触发close事件，此时30秒的应用层超时还未到期，因此timeout事件不会被触发。
• 在GKE容器中，TCP层的130秒超时远长于设置的30秒应用层超时，因此到30秒时应用层的timeout事件会先触发，之后TCP层才会完成自身的重试流程。

验证与统一超时的解决方法 #

验证系统TCP参数 #

• 在GKE Ubuntu容器中，查看TCP重传参数：

  cat /proc/sys/net/ipv4/tcp_retries2
  

  默认值15对应的总超时时间约为130秒，与你观察到的现象一致。
• Windows系统可通过netsh int tcp show global命令查看TCP重传相关配置。

统一超时的解决方案 #

若需要在不同系统中保持一致的超时时间，建议手动为HTTP请求设置应用层超时，主动控制连接生命周期：

const http = require('http');

console.log(new Date());
const req = http.request('http://x.x.x.x');
req.on('error', () => {});
req.on('close', () => { console.log('close ' + new Date()); });
// 设置30秒应用层超时，超时后主动销毁连接
req.setTimeout(30000, () => {
  req.destroy(new Error('Request timeout'));
  console.log('timeout triggered ' + new Date());
});

内容的提问来源于stack exchange，提问作者Sagi Mann