要真正启用upstream长连接池，必须协议（HTTP/1.1）、请求头（Connection空值）与keepalive连接池三者对齐；仅设keepalive无效。需在upstream块中配置keepalive N、proxy_http_version 1.1、proxy_set_header Connection ""，并合理设置keepalive_timeout和keepalive_requests，最后通过ss命令及压测验证连接复用效果。
要在 upstream 中真正启用长连接池、提升 Nginx 到后端的转发性能，不能只写 keepalive 32，必须协议、头、连接池三者对齐。否则仍是短连接，后端 TIME_WAIT 暴涨、延迟升高。
upstream 块内正确声明 keepalive
该指令只能出现在 upstream { } 块中，且必须在 http 块下定义。放在 server 或 location 中会报错：unknown directive "keepalive"。
-
keepalive N表示每个 worker 进程对每台后端服务器最多缓存 N 个空闲长连接 - 若你有 4 个 worker、2 台后端，理论最大空闲连接数为
4 × 2 × N - N 值需匹配后端承载力：Tomcat 默认
maxConnections=200，按 70% 安全水位，单 worker 建议设 32～48；Node.js/Go 类服务可从 16～32 起步 - 值不是越大越好——后端连接池太小（如 Go 默认
MaxIdleConnsPerHost=2），Nginx 设再大也连不上；后端不限制却设过高，可能耗尽其文件描述符
location 中强制启用 HTTP/1.1 并清空 Connection 头
Nginx 默认向上游发 HTTP/1.0 请求，不支持连接复用。仅配 keepalive 不生效。
- 必须添加
proxy_http_version 1.1; - 必须添加
proxy_set_header Connection "";（注意是空字符串，不是"keep-alive"） - 不要手动加
Keep-Alive头，Nginx 会自动处理 - 若后端返回
Connection: close（常见于错误响应或 WAF 干预），该连接立即释放，无法复用
控制空闲连接生命周期
keepalive_timeout 与 keepalive_requests 从 Nginx 1.15.3+ 开始才对 upstream 生效，老版本（如 1.12）只认 keepalive，不支持超时与请求数限制。
-
keepalive_timeout 20s;：空闲连接在池中最多保留 20 秒；建议比后端空闲超时（如 Tomcat 的connectionTimeout）小 5～10 秒，避免持有已失效连接 -
keepalive_requests 500;：单个空闲连接最多转发 500 次请求后主动关闭，防止后端状态泄漏或内存堆积；默认 100 过于保守，API 场景推荐 500～1000
验证是否真正生效
配置完不等于跑通，需实测确认连接复用状态：
- 运行
ss -tan | grep :8080 | grep ESTAB | wc -l（替换为你的后端端口），观察连接数是否稳定在预期范围，而非持续增长或剧烈波动 - 压测对比开启前后：后端 TIME_WAIT 数量下降、P95 延迟降低、建连耗时减少
- 检查后端响应头是否含
Connection: keep-alive；若返回Connection: close或缺失，说明中间有设备干扰或后端未正确配置
