proxy_http_version 1.1 是启用 nginx 与后端 http 长连接的强制前提，但必须协同 proxy_set_header connection "" 和 upstream keepalive n 三项配置才能真正复用连接；缺一不可，否则仍为短连接。
必须配齐的三项配置
缺一不可，否则连接仍会每次新建、立即断开：
-
显式声明协议版本：在 location 或 server 块中写
proxy_http_version 1.1;。Nginx 默认向上游发 HTTP/1.0 请求，而 1.0 不定义持久连接语义，不会带Connection: keep-alive，也不识别后端返回的Keep-Alive响应头。 -
清空透传的 Connection 头：添加
proxy_set_header Connection "";（注意引号内是空字符串）。客户端可能携带Connection: close或其他非法值，若原样转发，后端会误判并主动断连；清空后，Nginx 才能按自身逻辑自主管理连接生命周期。 -
启用 upstream 连接池：在 upstream 块中配置
keepalive 32;（数值按并发量调整，常见取值 16–128）。它表示每个 worker 进程最多为该后端缓存 32 个空闲长连接，供后续请求复用。
配套参数建议
仅基础三项还不够稳定，建议补充以下控制项：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
keepalive_timeout 60s;：空闲连接在 Nginx 端最多保留 60 秒，超时即关闭，避免堆积无效连接。 -
keepalive_requests 1000;：单个长连接最多承载 1000 次请求，防止长期占用或资源泄漏。 -
proxy_connect_timeout 5s;、proxy_send_timeout 30s;、proxy_read_timeout 30s;：根据后端响应节奏调优，避免因超时过短导致连接被提前中断。
后端服务也要支持 keep-alive
Nginx 配对了，后端也得“接得住”：
-
Tomcat：确认
connectionTimeout非零（如20000），且未显式禁用 keep-alive。 -
Node.js：默认支持，但需检查代码是否调用了
req.socket.destroy()或设置了server.keepAliveTimeout = 0。 -
Spring Boot：内嵌 Tomcat 可通过
server.tomcat.connection-timeout控制；若用 Undertow，需确认max-connections和io-threads合理。
验证是否真正生效
不能只看配置有没有写，要看连接行为：
- 执行
ss -tnp | grep :后端端口，观察ESTABLISHED连接数是否稳定维持（比如持续保持 20–30 条），而非随请求激增后迅速归零。 - 用
tcpdump抓包，确认同一客户端 IP:Port 到某台后端的 TCP 连接上，多个 HTTP 请求共享同一个连接（SYN/FIN 出现次数远少于请求数）。 - 检查 Nginx error log，避免频繁出现
upstream prematurely closed connection—— 这通常意味着后端提前断连，可能是 keep-alive 未开启或超时不匹配。
