Nginx 与 PHP-FPM 性能调优:先定位瓶颈,再改参数(2026-11-16)
调优应从请求路径和基线开始:用 Nginx 与 PHP-FPM 的状态和日志区分排队、上游处理、超时与资源瓶颈;进程池按内存和并发核算,Nginx 侧关注上游连接、缓冲与超时链路;每次只改一个变量并复测。本文未提供实测数字,具体默认值与版本差异需按实际环境核实。
如果 API.PLUS 的接口部署在 Nginx 与 PHP-FPM 之后,性能调优不应从复制一组“最佳参数”开始。更可靠的顺序是:先确认请求慢在哪一层,再用基线、单变量变更和复测验证假设。本文没有可用的实测环境、版本与压测数据,因此只讨论排查方法和配置边界,不提供性能数字;具体指令默认值与版本差异需按实际环境核实。
先把“慢”拆成可观察的环节#
至少记录请求量、并发数、P50/P95/P99 延迟、错误率,以及 Nginx 的上游响应时间、PHP-FPM 的活跃与空闲进程、CPU、内存和磁盘 I/O。Nginx 的 stub_status 与 PHP-FPM 的 status 页面能提供队列和进程线索,但应限制在内网或受控路径,避免暴露运行信息。
| 现象 | 优先检查 | 说明 |
|---|---|---|
| FPM 活跃进程接近上限,请求排队 | max_children、单进程内存、slowlog | 先判断是进程不足还是脚本变慢 |
| 499、502、504 增多 | 上游耗时、各层超时、FPM 日志 | 不要只调大超时,先找谁先断开 |
| CPU 不高但尾延迟高 | I/O、外部依赖、锁、DNS | 继续加 worker 可能只是扩大排队 |
Nginx 侧:关注连接、上游与超时链路#
worker_processes 和 worker_connections 决定连接处理能力,但反向代理还会占用到上游的连接,不能把两者相乘直接当作可服务客户端并发数。为上游启用连接复用时,要同时核对 FPM 的进程数、listen backlog 和超时设置,否则连接复用未必带来收益。响应缓冲有利于隔离慢客户端,但会增加内存或磁盘开销;上传接口则要单独检查请求体大小限制和客户端超时。建议把超时写成明确值,并通过 499/502/504 的分布判断是客户端放弃、上游拒绝还是上游超时。
PHP-FPM 侧:进程池是在内存和并发之间取舍#
static 固定进程数,适合负载稳定且内存可预测的场景;dynamic 维持一定空闲进程并按需伸缩;ondemand 在请求到来时创建进程,节省空闲内存但增加冷启动风险。选择哪种模式取决于流量形态,而不是“哪个更高级”。pm.max_children 的核算应从可用内存中扣除系统、Nginx 及其他同机服务占用,再除以单个 FPM 进程的实际 RSS,并留出余量。单进程内存应以运行期 RSS 为准,不能用代码包大小代替。
slowlog 和 request_slowlog_timeout 适合定位执行时间异常的具体脚本;request_terminate_timeout 与 Nginx 的 fastcgi_read_timeout 应放在同一条超时链路上考虑。若一层先断开,另一层看到的往往只是 502 或 504,而不是真正的根因。
变更时只改一个变量#
- 固定测试场景:同一接口、同一数据规模、同一缓存状态和并发模型;没有压测时,至少用生产监控做前后对比,并记录时间窗。
- 记录基线:软件版本、配置、机器规格、请求分布、错误率和资源曲线。
- 每次只改一个参数,保留可回滚配置。
- 复测时同时看尾延迟和错误率,不只看平均 QPS。
- 观察足够长时间,避免缓存预热或流量波动造成误判。
调参不能替代应用层修复#
如果耗时集中在数据库、外部 API、磁盘或锁竞争,调整 Nginx 与 PHP-FPM 往往只是把排队位置挪走。对 API 服务,还应先保证超时、重试、限流和错误返回可观测。本文未执行任何配置或压测,不提供“最佳值”;上线前需在目标版本和真实流量模型下验证。