Nginx 与 PHP-FPM 性能调优:先定位瓶颈,再改参数(2026-11-11)
Nginx 与 PHP-FPM 调优应先区分排队等待、后端处理慢与连接传输三类问题,再按 worker 容量、进程池上限、超时链与缓冲区逐项调整;每次只改一个变量,并用同一套度量复核。本文不含实测数据,具体数值需按自身环境与所使用版本的文档核实。
Nginx 与 PHP-FPM 的调优不是找一组“最优值”,而是一个顺序:先确认请求在哪个环节排队或变慢,再改对应参数,改完用同一套度量复核。本次没有可核验的压测记录,也没有可引用的外部来源,因此本文不提供任何“调优后提升多少”的结论,也不把具体数值当作推荐值写入配置。涉及默认值、指令可用性与版本差异的部分,请以你实际使用的版本文档为准(待核实)。
第一步:把“慢”拆成三类#
三类问题的信号不同,先分类再动手,能避免同时改多个参数后无法归因。
- 排队等待:PHP-FPM 进程池已满,新请求在监听队列里排队,甚至被拒绝。表现为延迟整体抬升、并发越高越明显。
- 后端处理慢:PHP 代码本身耗时,或它同步调用的下游服务慢。表现为特定路径慢、与并发关系不大。
- 连接与传输:到后端的连接没有复用、缓冲区不足导致响应落盘、超时链内外层错配。表现为偶发 502/504 或大响应明显偏慢。
502 与 504 只是排查起点,不是定论:前者通常意味着 Nginx 拿不到可用的上游连接,后者通常意味着等待上游响应超时。两者都可能由进程池耗尽引起,也可能完全无关,需要结合 PHP-FPM 的慢日志与进程状态判断。
Nginx 侧:容量上限与连接复用#
worker_processes 与 worker_connections 决定的是容量上限,不是性能开关。前者控制工作进程数量,后者是每个 worker 能同时处理的连接数上限。调整它们之前,先确认瓶颈确实在 Nginx 的连接层,而不是在 PHP-FPM 或下游。
FastCGI 场景下更容易被忽略的是 Nginx 与 PHP-FPM 之间的连接复用。fastcgi_keep_conn 控制是否保持到上游的连接,是否带来收益取决于请求模式与 PHP-FPM 的监听方式,需要在自己的环境中验证,不能直接假定。
PHP-FPM 池:进程数按内存定,不按 CPU 定#
pm.max_children 是硬上限。设小了,请求在队列中排队甚至被拒;设大了,进程之间争抢内存,可能触发 swap,反而拖慢全部请求。可用的做法是测量单个请求的峰值内存占用,再与可用内存比较并留出余量,而不是套用固定公式。
pm 的三种模式是取舍而非优劣:static 常驻固定数量进程,减少进程创建开销但内存长期占用;dynamic 按负载伸缩;ondemand 空闲时退出,适合低频服务,但会引入启动延迟。选择依据是请求的到达密度与内存预算。
request_terminate_timeout 用于终止执行过久的请求,它与 PHP 的 max_execution_time、Nginx 的 fastcgi_read_timeout 之间存在关系,应当逐层收敛而不是各处随意设置。
超时链:从外到内逐层收紧#
一条典型链路是:客户端 → 负载均衡 → Nginx → PHP-FPM → PHP 代码 → 下游依赖。常见的错配是外层超时比内层短:外层先断开并返回 504,内层仍在继续执行,日志看起来像“无故超时”。合理的做法是让内层超时略短于外层,使内层先失败并留下明确日志。
具体时长应基于业务中最慢请求的合理上界来定,这个上界只能通过测量得到。
缓冲区:过小落盘,过大浪费#
fastcgi_buffer_size 与 fastcgi_buffers 过小时,响应会被写入临时文件,增加 I/O;过大则每个连接占用更多内存。是否需要调整,取决于响应体大小的实际分布,而不是猜测。
改完怎么验证#
- 固定压测脚本与并发梯度,保证改动前后可比。
- 记录 p95/p99 与错误率,不要只看平均响应时间。
- 一次只改一个变量,记录改前值、改后值与回滚方式。
- 确认 PHP-FPM 队列长度与进程数在压测期间的实际变化。
下面的片段仅示意配置字段的位置与关系,未执行,也不是推荐取值:
# 未执行的示例:仅示意字段位置
upstream php_backend {
server unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
fastcgi_pass php_backend;
fastcgi_read_timeout 30s;
fastcgi_buffer_size 16k;
fastcgi_buffers 16 16k;
}
; 未执行的示例:php-fpm 池配置片段
pm = dynamic
pm.max_children = 待按内存测量结果确定
pm.start_servers = 待定
request_terminate_timeout = 待与上层超时协调
调优的产出不是一份“最佳配置”,而是一组你能复现的测量结果与对应改动记录。缺少这两样,任何参数值都只是猜测。