keepalive_requests 控制单个 http keep-alive 连接最多处理的请求数，达限后 nginx 发送 connection: close 并关闭连接；仅对 http/1.1 keepalive 连接生效，不适用于 http/2。
在 Nginx 中，keepalive_requests 用于控制一个长连接（HTTP Keep-Alive）最多能处理多少个请求，超过后主动关闭该连接。它不是限制“并发请求数”，而是限制“单个 TCP 连接生命周期内累计处理的请求数”。合理设置可防止连接长期占用、资源泄漏或被恶意复用。
作用机制与触发时机
keepalive_requests 是 Nginx 工作在 HTTP 层 的计数器，从客户端建立首个请求开始计数，每完成一个请求（无论成功或失败，只要响应已发出）就 +1。当计数值达到设定值时，Nginx 在当前响应头中添加 Connection: close，并关闭该 TCP 连接。
- 只对启用了 keepalive 的连接生效（需同时配置
keepalive_timeout和客户端支持 HTTP/1.1 或明确发送Connection: keep-alive） - 不适用于 HTTP/2 —— HTTP/2 天然复用连接，由
http_v2_max_requests控制（Nginx 1.19.10+ 支持） - 计数重置发生在新连接建立时，不是按时间重置
典型配置方式
该指令只能出现在 http、server 或 location 块中，推荐在 server 级统一设置：
server {
listen 80;
server_name example.com;
keepalive_timeout 60s;
keepalive_requests 100;
location / {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Connection '';
}
}
注意：proxy_set_header Connection '' 是关键，它清空客户端传来的 Connection 头，避免 Nginx 将 close 错误透传给上游，影响后端 keepalive 行为。
调优建议与常见误区
默认值是 100，对大多数业务足够；但需结合实际场景调整：
- 高吞吐 API 服务（如微服务间调用）：可适当提高到 500–1000，减少连接重建开销
- 含大文件上传/下载的站点：建议调低（如 20–50），防止慢连接长期占满 keepalive 连接池
- 遇到 “connection reset by peer” 或 Nginx 日志出现
client closed connection while waiting for request：检查是否因keepalive_requests触发关闭，而客户端仍在尝试复用 - 不要盲目设为 0 或极大值（如 10000）：0 表示禁用 keepalive；过大可能加剧 TIME_WAIT 积压或内存占用
如何验证是否生效
可通过抓包或 curl 检查响应头：
- 发起多个连续请求（如
curl -H "Connection: keep-alive" http://example.com/多次） - 在第 N 个响应中观察是否出现
Connection: close（N ≈keepalive_requests设置值） - 查看 Nginx access log，对比同一 client IP + port 的请求是否集中在少数连接上（借助
$connection_requests变量可记录当前连接已处理请求数）
