怎么配置 fastcgi_keep_conn on 强制开启 PHP-FPM 长连接复用避免路径调用时频繁创建套接字

作者：袖梨 2026-06-24

fastcgi_keep_conn on 仅是FastCGI协议层握手控制指令，必须协同upstream连接池（含keepalive、keepalive_requests、keepalive_timeout）、fastcgi_http_version 1.1与空Connection头，以及PHP-FPM的pm.max_children、pm.max_requests等参数对齐，三者缺一不可；Unix socket不支持keepalive，须用TCP。

fastcgi_keep_conn on 本身不是“强制开启长连接”的开关，它只是 FastCGI 协议层的一个握手控制指令。真正让 Nginx 与 PHP-FPM 复用 TCP 连接，必须三者协同：upstream 连接池 + 协议版本与头控制 + PHP-FPM 并发参数对齐。单独加这一行无效，还可能因其他配置冲突导致连接异常断开。

必须定义带 keepalive 的 upstream 块

Nginx 默认没有 upstream，所有 fastcgi_pass 127.0.0.1:9000 都是直连短连接，无法复用。

在 http { } 最上方（不能放在 server 或 location 内）添加：

upstream php_backend {    server 127.0.0.1:9000;    keepalive 8;    keepalive_requests 1000;    keepalive_timeout 60s;}

keepalive 8：每个 Nginx worker 最多缓存 8 个空闲连接
该值不能超过 PHP-FPM 的 pm.max_children（如后者为 10，设 8 较稳妥）
keepalive_requests 1000 应与 PHP-FPM 的 pm.max_requests 接近，防止单连接超请求数被主动关闭
keepalive_timeout 60s 是空闲连接保持时间，和全局 keepalive_timeout 无关

在 location 中启用协议级复用控制

替换原有 fastcgi_pass，并补全三项关键指令：

立即学习“PHP免费学习笔记（深入）”；

location ~ .php$ {    fastcgi_pass php_backend;    fastcgi_keep_conn on;    fastcgi_http_version 1.1;    fastcgi_set_header Connection "";    include fastcgi_params;}

fastcgi_keep_conn on 是必要但非充分条件，仅表示“不主动断开”
fastcgi_http_version 1.1 是协议基础，HTTP/1.0 不支持连接复用
fastcgi_set_header Connection "" 必须是空字符串（双引号内无空格、无字符），不是 "keep-alive" 或 "close"，否则 PHP-FPM 会误判并立即关闭连接
include fastcgi_params 不能省略，否则 SCRIPT_FILENAME 等关键参数丢失

同步调整 PHP-FPM 配置防止连接中断

PHP-FPM 必须“愿意留着连接”，否则 Nginx 复用也没用。检查 www.conf：

pm.max_children = 10 → upstream 的 keepalive 值建议 ≤ 8
pm.max_requests = 1000 → 和 upstream 的 keepalive_requests 对齐
request_terminate_timeout = 30s → 不宜过短，避免请求未完成就被 kill 导致连接异常中断
request_slowlog_timeout = 10s → 同理，避免慢日志触发中断
ping.path 和 ping.response 可保留，用于健康探测（非必需但推荐）

注意：若使用 Unix socket（如 fastcgi_pass unix:/run/php/php8.3-fpm.sock），keepalive 指令不生效，必须改用 TCP（127.0.0.1:9000）才能启用连接池。

验证是否真正生效

配置重载后，执行以下命令观察连接状态：

查看活跃连接数（应稳定在 keepalive 设定值附近）：
```
ss -ant | grep :9000 | grep ESTAB | wc -l
```
对比优化前后 TIME_WAIT 数量（正常可从数百上千降至 20 以内）：
```
ss -ant | grep TIME_WAIT | wc -l
```
检查 Nginx 错误日志，搜索 upstream prematurely closed 或 recv() failed 类报错，常见原因是 Connection "" 写成 " " 或 "close"