keepalive_requests 控制单个长连接最大请求数，默认100，React应用建议调至2000并配25s超时，需协同压缩、缓存及系统文件描述符优化。
React 应用构建为静态文件后，通常由 Nginx 托管。在高频请求场景（如大量用户同时访问、前端轮询、微前端子应用频繁加载资源）下，若未合理配置连接复用参数，可能引发连接耗尽、TIME_WAIT 堆积或上游响应延迟等问题。keepalive_requests 是关键调优项之一，但它常被误认为“越大越好”，实际需结合业务特征与系统资源权衡。
keepalive_requests 的作用和默认行为
Nginx 的 keepalive_requests 指单个长连接（keep-alive connection）上允许处理的最大请求数。达到该阈值后，Nginx 主动关闭该连接，客户端需新建连接继续请求。
- 默认值为 100，适用于一般网站；但在 React 单页应用中，一个页面加载常触发 20–50+ 个静态资源请求（JS/CSS/图片/字体），若启用 HTTP/1.1 keep-alive，这些请求可复用同一连接
- 设为 0 表示不限制（不推荐），长期复用连接可能导致内存缓慢增长、旧连接滞留、或掩盖真实连接管理问题
- 它与 keepalive_timeout 协同工作：前者控“次数”，后者控“时间”，两者任一条件满足即断连
高频请求下应如何设置 keepalive_requests
对以 React 为主、资源加载密集、且存在短周期轮询（如每 5 秒 fetch API）的站点，建议按以下逻辑调整：
- 将 keepalive_requests 提升至 1000–3000，覆盖典型用户单次会话内的全部资源加载 + 若干轮 API 请求
- 同步缩短 keepalive_timeout 至 15–30 秒，避免空闲连接长时间占用 worker 进程连接槽位
- 确认 React 构建产物已启用 Gzip/Brotli 压缩，并使用 cache-control 长缓存（如 max-age=31536000）减少重复资源请求量——这才是降低连接压力的根本手段
- 若使用 Nginx 作为反向代理（如转发 API 到后端），keepalive_requests 仅影响客户端到 Nginx 的连接，不影响 Nginx 到 upstream 的连接池配置（需单独配 proxy_http_version 1.1 + proxy_set_header Connection '' + proxy_set_header Keep-Alive ''）
验证是否生效及常见误区
配置后不能仅看服务是否启动，需通过实际连接行为验证：
- 用
curl -I http://your-site.com/static/main.js查看响应头是否有Connection: keep-alive，并多次执行观察是否复用同一 TCP 连接（可用netstat -an | grep :80 | grep ESTABLISHED | wc -l辅助观察） - 注意 Chrome DevTools Network 标签页中请求的 “Protocol” 列：HTTP/1.1 + keep-alive 复用表现为多个请求共享同一 connection ID；HTTP/2 下该参数无效（HTTP/2 默认多路复用）
- 误将 keepalive_requests 和 worker_connections 混淆：后者是每个 worker 进程能处理的并发连接总数，属于更底层的容量限制
- 未配合调大 worker_rlimit_nofile 和系统级 ulimit -n，导致高并发时因文件描述符不足而拒绝新连接，此时调 keepalive_requests 无意义
一个轻量但实用的 Nginx 配置片段
适用于托管 build 后的 React 静态资源（假设部署在 /var/www/react-app）：
server {
listen 80;
server_name example.com;
<pre class='brush:php;toolbar:false;'>root /var/www/react-app;
index index.html;
# 启用长连接
keepalive_requests 2000;
keepalive_timeout 25s;
# SPA 路由 fallback
location / {
try_files $uri $uri/ /index.html;
}
# 静态资源强缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}}
