Node.js HTTP服务器Socket超时问题：设置超时无效的原因探究

问题原因 #

在Node.js v16.x的HTTP模块中，TCP连接建立触发connection事件后，一旦HTTP请求开始处理，http.ServerResponse对象会自动将socket的空闲超时重置为默认的5秒——这是HTTP模块内置的逻辑，用于避免空闲连接长期占用资源。你在connection事件里设置的socket.setTimeout(300000)会被后续请求处理流程覆盖，所以无论设多少值，最终都会被改成5秒，导致超时关闭。

另外，你返回的Keep-Alive响应头仅用于告知客户端保持连接，服务器端的socket超时逻辑由Node.js HTTP模块内部控制，和响应头的timeout=300参数无关——该参数只是建议客户端的超时时间，不影响服务器端的实际超时设置。

延迟设置超时生效的原因 #

当你延迟1秒执行socket.setTimeout时，HTTP请求的处理流程已经完成（响应已发送给客户端），ServerResponse不会再修改socket的超时时间，此时你的设置才会生效，socket会按照指定的300秒超时。

正确解决方法 #

1. 修改HTTP服务器全局配置

直接在创建http.Server时配置keepAliveTimeout和headersTimeout，这两个参数是Node.js专门控制长连接超时的核心配置：

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, {
    'Connection': 'keep-alive',
    'Keep-Alive': 'timeout=300',
    'Content-Type': 'application/javascript'
  });
  res.end('your content');
});

// 设置长连接空闲超时为300秒
server.keepAliveTimeout = 300000;
// 设置请求头接收超时，需大于keepAliveTimeout，避免异常关闭
server.headersTimeout = 301000;

server.listen(3000);

• keepAliveTimeout：HTTP响应发送后，空闲连接保持打开的时长（毫秒）
• headersTimeout：服务器等待客户端发送完整请求头的时长，必须大于keepAliveTimeout

2. 在request事件中设置单个连接超时

如果需要针对不同请求设置不同超时，可在request事件中修改socket超时：

server.on('request', (req, res) => {
  // 此处设置的超时不会被后续流程覆盖
  req.socket.setTimeout(300000);
  
  res.writeHead(200, {
    'Connection': 'keep-alive',
    'Keep-Alive': 'timeout=300'
  });
  res.end('your content');
});

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