keepalive_requests是Nginx限制单条长连接最大请求数的硬性配额，达限即发Connection: close并断连，与keepalive_timeout共同决定生命周期，取先触发者；默认100偏保守，React应用建议2000，API网关推荐1000–3000，需协同timeout、upstream长连接及压缩缓存优化。
通过 keepalive_requests 限制单条长连接的请求复用次数，是 Nginx 控制连接生命周期、防止内存持续增长的关键手段。它不直接限制“事件循环”，而是限制一条 keep-alive 连接上最多处理多少个请求后主动关闭连接，从而切断潜在的资源累积路径。
keepalive_requests 的作用机制
该指令定义了在一条复用的 HTTP/1.1 keep-alive 连接上，Nginx 最多允许处理多少个请求。达到阈值后，Nginx 会在响应头中添加 Connection: close，并关闭该 TCP 连接。这能有效避免：
- 单连接长期存活导致的 worker 进程内请求上下文、buffer、变量引用等未及时释放
- 客户端异常（如漏发 FIN、半开连接）造成连接滞留，间接拖慢 event loop 处理效率
- 上游或模块中依赖连接生命周期管理的资源（如 Lua 协程栈、OpenResty 的 cosocket 连接池）持续占用内存
合理设置 keepalive_requests 值
默认值为 100，对多数业务偏保守；过高（如设为 0 或极大值）会放大内存滑坡风险。建议结合实际压测与监控调整：
- 观察
nginx_stub_status中Active connections与Reading/Writing/Waiting分布，若 Waiting 连接长期 > 500 且平均复用请求数 > 500，说明连接“太老” - 使用
ss -tni | grep :80 | awk '{print $3}' | sort | uniq -c | sort -nr查看各连接已传输请求数（需开启tcp_info支持） - 从 200–500 区间起步测试，配合 Prometheus + nginx-vts-exporter 监控 per-connection request count 分位数
配合其他机制协同防滑坡
keepalive_requests 需与以下配置联动才能发挥最大效果：
-
keepalive_timeout：必须小于或等于该值，否则连接可能因超时先关闭，使keepalive_requests失效；建议设为keepalive_requests触发周期的 1.5–2 倍（例如请求速率为 100 req/s，设 timeout=3s） -
reset_timedout_connection on：对已超时但未关闭的连接强制重置，防止僵死连接持续占内存 - OpenResty 场景下，在
log_by_lua*中调用ngx.var.connections_active和自定义计数器，对高复用连接主动ngx.exit(444)
验证是否生效
启用后可通过以下方式确认行为符合预期：
- 用
curl -H "Connection: keep-alive" -v http://host/path连续发起请求，第N+1次（N = keepalive_requests）响应头应含Connection: close - 抓包观察 TCP 层：第 N 个请求响应后，服务端发出 FIN 包，而非等待客户端断连
- 对比开启前后，
pmap -x $(pgrep nginx)中 worker 进程 RSS 增长斜率是否明显放缓
