必须四者对齐:nginx启用http/1.1、清空connection头、upstream设keepalive值;tomcat调大connectiontimeout(≥75s)和maxkeepaliverequests(如1000),并避免响应含connection: close。

要让 Nginx 和后端 Tomcat 之间真正复用 TCP 连接,不能只在 Nginx 上加一行 keepalive,必须让协议版本、请求头控制、连接池设置和 Tomcat 配置四者对齐。任一环节错位,连接就无法复用,每次请求仍会新建 TCP 连接,白白消耗握手开销和系统资源。
确保 Nginx 到 Tomcat 的连接池真正启用
这是最关键的一步,三项配置缺一不可:
-
显式启用 HTTP/1.1:在
location或server块中写proxy_http_version 1.1;。HTTP/1.0 不支持长连接,不设此项,Nginx 会降级通信,Tomcat 收到后直接断连。 -
清空 Connection 请求头:加
proxy_set_header Connection '';。否则 Nginx 可能将客户端传来的Connection: close转发给 Tomcat,导致 Tomcat 主动关闭连接。 -
声明 upstream 连接池大小:在
upstream块内写keepalive 32;(常见值 16–64)。它表示每个 worker 进程最多缓存 32 个空闲连接到该 Tomcat 实例——8 个 worker 就是最多 256 条空闲连接。
Tomcat 端必须配合空闲保持能力
Nginx 想复用,Tomcat 得“愿意等”。重点调两个参数:
-
connectionTimeout:建议设为 ≥ 75000(即 75 秒),必须明显大于 Nginx 的keepalive_timeout(比如 Nginx 设 60 秒,Tomcat 至少设 75 秒)。否则 Nginx 还没来得及复用,Tomcat 已先关闭连接。 -
maxKeepAliveRequests:设为100或更高(如1000)。默认值100表示单连接最多处理 100 个请求后强制关闭;若前端请求密集(如 SPA 页面加载 JS/CSS/图片),建议调高,避免连接过早失效。
Spring Boot 用户可在 application.properties 中配置:server.tomcat.connection-timeout=75000server.tomcat.max-keep-alive-requests=1000
避免常见干扰项导致复用失败
这些细节看似小,却常让配置“形同虚设”:
- Tomcat 响应头里出现
Connection: close(常见于 5xx 错误响应、调试开关开启、WAF 插入拦截头),Nginx 会立即释放该连接,无法进入复用池。 - 健康检查过于频繁且未使用 HTTP/1.1 协议,或未配置
match规则,探测请求会耗尽空闲连接。 - 使用了
proxy_buffering off+proxy_cache组合,在某些旧版 Nginx 中可能绕过 keepalive 连接池。
验证是否真的生效
别只看配置写了没,用实际指标判断:
- 在 Tomcat 服务器执行
ss -s | grep -i time_wait,持续观察 —— 复用率提升后,TIME_WAIT数量应明显下降。 - 在 Nginx 开启 debug 日志,搜索
keepalive.*reuse,确认日志中出现复用行为,而非大量create connection。 - 用
curl -v多次请求同一接口,结合ss -t观察源端口是否复用(相同本地端口连续通信)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











