Node.js/Express中keepAliveTimeout配置无效问题求助

1. 排除反向代理/负载均衡的影响 #

直接通过Node服务器的端口访问（绕开Nginx、Apache等代理），用curl测试：

curl -v -H "Connection: keep-alive" http://localhost:${PORT} --keepalive-time 60

如果直接访问后连接不再5秒断开，说明问题出在代理层：

• 以Nginx为例，需要在配置中增加：

  http {
    # 保持连接超时时间，和Node的keepAliveTimeout一致或更长
    keepalive_timeout 180s;
    # 单个连接可处理的请求数，按需调整
    keepalive_requests 1000;
  }
  

  重启Nginx后再测试。

2. 检查客户端的Keep-Alive配置 #

确保客户端请求时携带Connection: keep-alive头，并且支持持久连接：

• 浏览器默认会发送该头，但如果是自定义客户端（比如小程序、后端服务调用），需要显式开启Keep-Alive。
• 用curl测试时加上--keepalive-time参数，保持连接活跃。

3. 排查Express应用内的干扰配置 #

• 检查是否强制关闭连接：搜索代码中是否有res.set('Connection', 'close')或类似设置，这会覆盖服务器的Keep-Alive策略，导致连接立即关闭。
• 检查其他超时设置：确认是否设置了server.setTimeout(5000)，这个是整个连接的超时时间，优先级高于keepAliveTimeout，会强制5秒后断开连接。如果有，移除或调整为更长时间。
• 确认HTTPS/HTTP区别：如果是HTTPS服务器，确保是在https.createServer()返回的实例上设置keepAliveTimeout，而非HTTP实例。

4. Node.js版本相关细节（16.14.2） #

Node.js 16.x中，headersTimeout必须比keepAliveTimeout至少大1秒（你的设置是613 vs 603，符合要求），但需要注意：

• 如果服务器在headersTimeout时间内未收到客户端的下一个请求头，会断开连接。确保客户端在Keep-Alive周期内发送请求或心跳。
• 可以打印服务器配置确认生效：

  console.log('keepAliveTimeout:', server.keepAliveTimeout);
  console.log('headersTimeout:', server.headersTimeout);
  

  若输出正确，说明配置已生效，问题在其他环节。

5. 测试连接状态 #

用netstat或lsof查看连接状态：

# Linux/macOS
netstat -an | grep ${PORT}
# 或
lsof -i :${PORT}

如果连接在5秒后变为TIME_WAIT，说明是客户端主动断开；如果是CLOSED，则是服务器或代理断开。

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