06.5.8.10 Nginx 与 FPM 协作
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.8 PHP 配套技术栈
06.5.8.10-001 一个 PHP 请求从浏览器到返回经过哪些环节?
一句话结论
链路为浏览器请求 → Nginx 监听匹配 location → 静态资源直接返回;PHP 请求通过 FastCGI 协议转发到 php-fpm 进程 → FPM 拉起 PHP 解释执行脚本 → 响应按 FastCGI 回传 Nginx → Nginx 组装 HTTP 响应返回客户端。
概念解释
Nginx 不直接解释 PHP,它作为 HTTP 入口与反向代理,负责连接管理、静态资源、限流与转发;php-fpm 是 FastCGI 进程管理器,维护 PHP worker 进程池。两者通过 FastCGI 协议(Unix socket 或 TCP)通信。脚本路径、文档根目录、请求方法、查询串等通过 FastCGI 参数传递。
原理流程
- Nginx 接收 HTTP 请求,按 server_name 与 location 规则匹配。
- 静态文件命中则由 Nginx 读文件并设置缓存头直接返回。
.php请求构造 FastCGI 参数,转发到 FPM 监听地址。- FPM 选择空闲 worker 执行 PHP,输出回传 Nginx,Nginx 补齐响应头后返回客户端。
代码或图示
// 文档示例:典型 Nginx + FPM 转发配置(配置写在 nginx.conf / 站点配置中)
// location ~ \.php$ {
// fastcgi_pass 127.0.0.1:9000;
// fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
// include fastcgi_params;
// }
// PHP 侧只看到 $_SERVER 中由参数注入的脚本名、请求方法与查询串
常见误区
- 以为 Nginx 内嵌 PHP 解释器:Nginx 只做转发,PHP 执行完全在 FPM 进程内。
- 把 FPM 当成 Web 服务器:FPM 只说 FastCGI,不能直接接收浏览器 HTTP 请求。
追问
- 通信能用 Unix socket 吗?答:可以,同机部署常用 socket 减少 TCP 开销;跨机部署只能用 TCP。
- 请求体在哪里缓冲?答:Nginx 先接收并缓冲请求体,再转发给 FPM;大上传受 client_max_body_size 控制。
06.5.8.10-002 Nginx location 匹配优先级是怎样的?
一句话结论
匹配顺序为精确匹配 = 优先,其次前缀匹配(最长前缀与 ^~ 修饰),再按配置顺序匹配正则 ~/~*,最后落到普通前缀;配置不当会导致 PHP 请求被静态规则截走或漏转 FPM。
概念解释
= 精确命中立即停止;^~ 前缀命中后不再检查正则;正则按书写顺序匹配,先命中先生效;普通前缀作为兜底。静态资源与 PHP 脚本的 location 要分别覆盖,避免 .php 请求落到静态目录规则下返回源码或 404。
原理流程
- 先找
=精确匹配,命中即使用。 - 记录所有前缀匹配中的最长前缀;若最长前缀带
^~,停止正则检查。 - 否则按配置文件顺序检查正则,命中即用。
- 正则都不命中则使用最长普通前缀。
代码或图示
// 文档示例:站点 location 划分
// location = /healthz { return 200 'ok'; } # 精确匹配
// location ^~ /static/ { root /var/www/assets; } # 前缀优先,不再走正则
// location ~ \.php$ { fastcgi_pass fpm:9000; } # 正则转发 FPM
// location / { try_files $uri $uri/ /index.php?$query_string; } # 前端路由兜底
常见误区
- 正则 location 顺序随意放:靠前的正则先命中,可能截走本该由其他规则处理的路径。
- 静态目录规则漏掉 PHP 防护:静态目录内上传的
.php文件若可被解析,存在执行风险。
追问
try_files起什么作用?答:按候选路径依次检查文件是否存在,最后一项可内部转发到后端脚本或路由。- 前端 SPA 路由怎么配?答:文件不存在时转发到入口脚本
index.php或前端静态首页,由路由层处理。
06.5.8.10-003 fastcgi 转发必须配置哪些关键参数?
一句话结论
核心参数是 SCRIPT_FILENAME(要执行的脚本绝对路径)与 DOCUMENT_ROOT,配合 REQUEST_METHOD、QUERY_STRING、PATH_INFO、CONTENT_TYPE、CONTENT_LENGTH 等;参数缺失会导致 FPM 找不到脚本或 $_SERVER 信息不全。
概念解释
FastCGI 参数是 Nginx 注入到 PHP $_SERVER 的环境变量。SCRIPT_FILENAME 决定 FPM 打开哪个脚本,路径拼错是 502/404 的常见原因。fastcgi_params 基础文件提供通用参数,业务站点按需追加 SCRIPT_FILENAME 等。参数名大小写与 PHP 超全局对应关系需按 FastCGI 约定核对。
原理流程
- Nginx 读取请求方法、查询串、请求头与请求体元信息。
- 拼接脚本绝对路径
$document_root$fastcgi_script_name作为SCRIPT_FILENAME。 - 注入内容类型、内容长度等参数后转发 FPM。
- FPM 按参数定位脚本,PHP 从
$_SERVER读取这些变量。
代码或图示
// 文档示例:关键 fastcgi 参数
// fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
// fastcgi_param DOCUMENT_ROOT $document_root;
// fastcgi_param REQUEST_METHOD $request_method;
// fastcgi_param QUERY_STRING $query_string;
// fastcgi_param PATH_INFO $fastcgi_path_info;
// fastcgi_param CONTENT_TYPE $content_type;
// fastcgi_param CONTENT_LENGTH $content_length;
常见误区
SCRIPT_FILENAME写成相对路径:FPM 工作目录不同会找不到脚本,必须给绝对路径。- 复制旧配置漏改
DOCUMENT_ROOT:脚本路径与实际部署目录不一致,返回 404 或错误脚本。
追问
SCRIPT_NAME与SCRIPT_FILENAME区别?答:前者是脚本路径名,后者是磁盘绝对路径;FPM 执行依赖后者。- 环境变量怎么传给 PHP?答:通过 fastcgi_param 或 FPM 进程环境注入;敏感配置走环境变量与配置文件,不写死在站点配置里。
06.5.8.10-004 Nginx 与 FPM 之间的超时链如何配合?
一句话结论
超时链包含 Nginx 到 FPM 的连接超时、读超时、发送超时,以及 FPM 自身的 request_terminate_timeout 与 PHP max_execution_time;各层超时要逐层合理设置,避免外层先断而 PHP 仍在跑,或内层先杀导致响应丢失。
概念解释
fastcgi_connect_timeout 控制连接 FPM 等待;fastcgi_read_timeout 等待 FPM 响应输出;fastcgi_send_timeout 向 FPM 发送请求超时。FPM request_terminate_timeout 到点终止 worker;PHP max_execution_time 限制脚本执行时间。外层超时小于内层时,Nginx 先返回 504 但 PHP 进程仍可能继续执行。
原理流程
- 估算接口正常耗时与最慢下游耗时,确定脚本执行上限。
- PHP
max_execution_time设为业务可接受上限,FPM 终止时间略高于或对齐。 - Nginx 读超时大于 FPM 处理上限,避免 Nginx 先误判。
- 超时后逐层记录日志,区分是连接不上、响应过慢还是脚本被终止。
代码或图示
// 文档示例:超时配置方向(具体数值按业务压测确定,默认值待确认)
// fastcgi_connect_timeout 3s; // 连不上 FPM 快速失败
// fastcgi_read_timeout 60s; // 等待 FPM 输出
// php.ini: max_execution_time = 30
// fpm.conf: request_terminate_timeout = 35
// 注意:读超时是两次输出之间的等待,不是脚本总时长,行为以版本为准
常见误区
- 三层超时随意复制:Nginx 超时比 PHP 短,客户端已 504,后端还在写库,造成重复提交。
- 把
max_execution_time当成总墙钟时间:它统计脚本 CPU 执行时间,sleep 等等待行为与版本实现有关,待确认。
追问
- 长任务为什么不在 PHP-FPM 里跑?答:FPM worker 被长任务占用会耗尽进程池;长任务应投递到异步消费者或队列后台执行。
- 超时后 worker 状态怎么看?答:FPM status 页查看活跃/空闲进程与慢日志,确认是否有进程被终止或卡住。
06.5.8.10-005 FastCGI 缓冲区如何影响大响应与 502?
一句话结论
fastcgi_buffer_size 与 fastcgi_buffers 控制 Nginx 缓冲 FPM 响应的块数与单块大小;响应头与首块走 buffer_size,响应体走 buffers;缓冲区不足时 Nginx 会临时写磁盘,极端配置下可能出现 502 或响应异常。
概念解释
Nginx 默认先缓冲 FPM 响应再发给客户端,降低 worker 被慢客户端拖住的风险。缓冲区数量与大小按典型响应体估算;响应过大超过缓冲会上临时文件。fastcgi_busy_buffers_size 控制已发送给客户端的缓冲上限。大响应(导出报表、大 JSON)要单独评估缓冲与超时配置。
原理流程
- 统计典型接口响应体大小分布,确定 buffers 块数与块大小。
- 响应头与首行占用 buffer_size;后续响应体分配 buffers。
- 缓冲写满后按 busy 阈值边发边缓冲,超出部分落临时目录。
- 大文件下载不缓冲进内存,应走静态文件或分片下载链路。
代码或图示
// 文档示例:缓冲配置方向(数值按响应体大小压测确定,待确认)
// fastcgi_buffer_size 16k;
// fastcgi_buffers 8 16k;
// fastcgi_busy_buffers_size 32k;
// 导出类大响应:避免一次性缓冲全量,改为流式输出或异步生成后下载
常见误区
- 缓冲配置过小又遇大响应:频繁落盘临时文件,延迟升高;配置过大则内存占用上升。
- 混淆代理缓冲与 FastCGI 缓冲:两者参数前缀不同,作用对象分别是后端 HTTP 服务与 FPM。
追问
- 关闭缓冲会怎样?答:Nginx 边收边发,慢客户端直接拖住 FPM worker;一般只对 SSE/流式响应考虑关闭。
- 临时目录权限不足会报错吗?答:会出现写临时文件失败的错误,需核对 Nginx 运行用户对临时目录的权限。
06.5.8.10-006 502 Bad Gateway 常见归因有哪些,怎么逐项排除?
一句话结论
502 表示 Nginx 从 FPM 拿到无效或无响应,常见原因:FPM 未启动/地址端口错误、进程池耗尽、脚本路径错误、FastCGI 协议不匹配、FPM 崩溃或被 OOM 杀死;排查顺序从连通性到进程池再到脚本与日志。
概念解释
502 是网关层错误,不是 PHP 业务异常页。先区分 Nginx 能否连上 FPM:连不上看地址与进程;连上了但响应非法看脚本路径与协议;进程池满则新连接排队或拒绝。FPM 错误日志、Nginx error.log、系统 OOM 记录是三类关键证据。
原理流程
- 检查 FPM 进程与监听地址:端口/socket 是否与
fastcgi_pass一致。 - 看 Nginx error.log 报错类型:连接拒绝、超时、无效响应头还是协议错误。
- 查 FPM status 与错误日志:进程池是否打满、worker 是否频繁退出。
- 核对
SCRIPT_FILENAME路径与部署目录一致,排除脚本找不到导致的异常响应。
代码或图示
// 文档示例:排查命令方向(在部署环境执行,本机无对应服务实例)
// 查看 FPM 监听:ss -lntp | grep 9000 或 ps -ef | grep php-fpm
// 查看进程池:FPM status 页中 active / idle / max children reached
// 查看日志:Nginx error.log、FPM www-error.log、系统 dmesg 中的 OOM 记录
// 待确认:各日志路径以实际部署配置为准
常见误区
- 一看到 502 就改 PHP 代码:多数 502 是连通性、进程池或路径问题,与业务逻辑无关。
- 进程池打满只加 max_children:不定位慢接口与下游阻塞,加进程只会把问题转移到数据库与内存。
追问
- socket 文件权限错误表现为什么?答:Nginx 连接 socket 被拒绝或无权限访问,error.log 记录连接失败;需核对 socket 属主与权限。
- FPM 被 OOM 杀死怎么判断?答:系统日志中有 OOM 记录,FPM 进程数骤降;结合内存占用与泄漏分析。
06.5.8.10-007 504 Gateway Timeout 与 502 如何区分?
一句话结论
504 是 Nginx 等待 FPM 响应超时,FPM 在线但处理过慢;502 是连不上或响应无效。504 多由慢脚本、阻塞下游、进程池排队或超时配置不当引起。
概念解释
504 发生在已建立 FastCGI 连接后,FPM 未能在 fastcgi_read_timeout 内输出响应。常见根因:PHP 等待慢数据库/外部接口、锁竞争、进程池满导致请求排队、同步重计算。客户端超时与后端实际耗时可能不一致,需同时看 Nginx、FPM 慢日志与下游指标。
原理流程
- 确认 Nginx error.log 为读超时而非连接拒绝。
- 查 FPM 慢日志与 status,定位耗时最长的脚本与下游依赖。
- 区分是进程排队(active 打满)还是单脚本执行慢。
- 优化慢下游、异步化长任务,或按业务调整超时与进程池参数。
代码或图示
// 文档示例:504 排查对照
// Nginx: upstream timed out (110: Connection timed out) while reading response header
// FPM slow log: 记录超出 slowlog 阈值的慢脚本与堆栈
// 下游指标:数据库慢查询、HTTP 外部接口耗时、Redis 命令耗时
// 待确认:slowlog 阈值与日志路径以 fpm.conf 为准
常见误区
- 把 504 当成数据库报错:数据库只是慢脚本的可能根因之一,需要链路证据。
- 直接调大 read_timeout 掩盖问题:超时变大只是让客户端等更久,进程池占用更久,最终仍会雪崩。
追问
- 排队导致的 504 怎么识别?答:active 进程数长期满、请求在 FPM 队列等待;此时脚本本身不一定慢。
- 超时后用户重复提交怎么办?答:接口做幂等与提交防重,后端长任务转异步,避免超时重试产生重复副作用。
06.5.8.10-008 静态资源为什么应由 Nginx 直接返回?
一句话结论
静态文件(图片、CSS、JS、字体)由 Nginx 直接读文件返回并设置缓存头,不进 FPM;这样避免 PHP 进程被静态请求占用,响应路径短、并发能力高。
概念解释
静态资源无业务逻辑,Nginx 内核级文件发送与缓存头部处理效率远高于 PHP 走一遍 FPM。合理配置 root/alias、过期时间、压缩与缓存命中,可降低后端压力。动态页面与静态资源在 location 层分开路由。
原理流程
- 按路径前缀划分静态目录,配置 root 与索引文件规则。
- Nginx 检查文件存在,命中则读取并返回,带
Expires/Cache-Control。 - 不存在的路径按前端路由规则兜底转发。
- 静态目录禁止解析
.php,防止上传文件被执行。
代码或图示
// 文档示例:静态资源规则
// location ^~ /static/ {
// root /var/www/app/public;
// expires 7d;
// add_header Cache-Control "public, immutable";
// }
// 安全约束:静态目录内 location ~ \.php$ { deny all; }
常见误区
- 让 PHP 输出静态文件内容:每个静态请求占用一个 FPM worker,静态流量大时迅速打满进程池。
- 静态资源不设缓存头:浏览器重复回源,带宽与后端压力增加。
追问
- 带版本号的静态资源怎么缓存?答:文件名含内容哈希时可设长缓存与 immutable;无哈希资源更新要缩短缓存或加版本查询串。
- 大文件下载走哪里?答:Nginx 直接发送文件,或配合 X-Accel-Redirect 由脚本鉴权后交回 Nginx 发送。
06.5.8.10-009 文件上传在 Nginx + FPM 链路上有哪些限制?
一句话结论
上传大小受 client_max_body_size 限制,请求体先由 Nginx 缓冲到临时目录再转给 FPM;超时、临时目录空间与权限、PHP 上传配置共同决定能否上传成功,超大文件应走分片或对象存储直传。
概念解释
Nginx 层限制请求体总量,超限返回 413;FPM/PHP 层另有 upload_max_filesize、post_max_size 等限制。上传临时目录需要 Nginx 运行用户可写。单次大文件上传容易触发超时与缓冲盘占用,工程上采用分片上传、断点续传或前端直传对象存储。
原理流程
- 配置 Nginx 请求体上限,核对 PHP 上传与 POST 上限不低于业务需要。
- 确认上传临时目录存在、空间充足且权限正确。
- 普通小文件经 Nginx 缓冲后由 PHP 接收处理。
- 大文件改为分片上传:前端切片、后端合并,或直传对象存储并回调确认。
代码或图示
// 文档示例:上传相关配置方向(数值按业务文件类型确定,待确认)
// Nginx: client_max_body_size 20m; client_body_temp_path 可写目录;
// PHP: upload_max_filesize / post_max_size / max_file_uploads
// 大文件:前端分片 → 后端校验合并;或服务端签发预签名 URL,浏览器直传对象存储
常见误区
- 只改 Nginx 上限忘了 PHP 上限:Nginx 放过的请求在 PHP 层被拒,表现为上传数组为空。
- 大文件整体经 PHP 接收:占用 worker 时间长、内存与临时盘压力大,超时风险高。
追问
- 413 与上传数组为空分别看哪层?答:413 是 Nginx 请求体超限;
$_FILES为空多为 PHPpost_max_size/upload_max_filesize超限或临时目录问题。 - 分片合并怎么做?答:前端按片上传记录序号,后端校验后按序合并;合并完成清理临时分片。
06.5.8.10-010 Nginx 限流有哪两类,配置口径是什么?
一句话结论
limit_req 按请求速率限流(漏桶模型,支持 burst 排队),limit_conn 按并发连接数限流;两者分别控制单位时间请求量与同时占用连接,可按 IP、接口或自定义键组合使用。
概念解释
limit_req_zone 定义键与速率,limit_req 在 location 生效,burst 允许短时超出排队,nodelay 表示突发不等待立即处理。limit_conn_zone 按键统计并发连接,超过限制拒绝。限流是入口保护,不能替代业务层按用户/资源的细粒度限流。
原理流程
- 定义限流键(如
$binary_remote_addr)与共享内存区域。 - 设定速率、burst 队列与是否 nodelay。
- 在对应 location 应用规则,超限返回指定状态码。
- 监控被拒数量,按压测结果调整阈值。
代码或图示
// 文档示例:Nginx 限流配置方向
// limit_req_zone $binary_remote_addr zone=perip:10m rate=10r/s;
// location /api/ {
// limit_req zone=perip burst=20 nodelay;
// limit_conn perip 50;
// }
// 注意:Nginx 限流按入口维度,集群下各节点独立计数;细粒度与全局限流见 Redis 限流章节
常见误区
- 以为 Nginx 限流就是全局限流:单节点计数,多实例部署下总量等于各节点之和。
- burst 设过大:突发请求排队等待,延迟升高,限流失去快速拒绝的意义。
追问
- 限流返回什么状态码?答:默认 503,可配置为 429;响应体可自定义提示。
- 登录/短信接口怎么单独限?答:按接口 location 用更严格的 zone 与键(IP + 用户名维度需在业务层实现)。
06.5.8.10-011 Nginx 层能做哪些访问控制与基础防护?
一句话结论
Nginx 可做 IP 黑白名单、基本认证、请求方法限制、静态目录保护、请求体与连接上限,以及接入 WAF 规则层;它是入口第一道防线,业务鉴权、参数校验与注入防护仍在 PHP 应用层完成。
概念解释
allow/deny 按 IP 控制访问;auth_basic 做用户名密码校验;限制只允许特定 HTTP 方法;敏感路径与静态目录做访问隔离。Web 应用层防火墙规则可在 Nginx 层或独立 WAF 服务执行,识别常见攻击特征;但应用内权限、越权与业务参数风险不能靠 Nginx 解决。
原理流程
- 梳理需要限制的后台、内网接口与静态目录。
- 配置 IP 名单、认证或方法限制。
- 接入规则层检查请求头、URI 与请求体特征。
- 应用层补齐身份认证、授权与输入校验,形成分层防护。
代码或图示
// 文档示例:访问控制规则方向
// location /admin/ {
// allow 10.0.0.0/8;
// deny all;
// auth_basic "admin";
// auth_basic_user_file /etc/nginx/.htpasswd;
// }
// 方法限制:if ($request_method !~ ^(GET|POST)$) { return 405; }
常见误区
- 把 Nginx 当成完整 WAF:规则层只覆盖已知特征,业务越权与逻辑漏洞仍需应用层防护。
- 后台只靠前端隐藏路径:必须在入口与应用双层做访问控制。
追问
- 密码文件怎么生成?答:用 htpasswd 工具生成加密条目存入
auth_basic_user_file;文件权限受限。 - 限流与访问控制冲突时谁先生效?答:按 location 内规则顺序与模块执行顺序处理,具体行为以 Nginx 版本为准,待确认。
06.5.8.10-012 FPM 进程管理模式有哪几种,参数如何配合?
一句话结论
FPM 进程管理分 static(固定进程数)、dynamic(按需增减)、ondemand(空闲不常驻,请求时拉起);核心参数为 pm.max_children、pm.start_servers、pm.min/max_spare_servers、pm.max_requests,按内存与并发量测算。
概念解释
static 恒定启动指定数量 worker;dynamic 启动时起 start_servers,按空闲区间动态伸缩;ondemand 无请求时不保留空闲进程,请求到达才 fork。max_children 是 worker 总数上限,决定并发处理能力;max_requests 控制单进程处理一定数量后重启,回收内存泄漏。进程模型细节与默认值以 FPM 版本为准,待确认。
原理流程
- 按单 worker 平均内存与服务器可用内存估算
max_children上限。 - 按峰值并发与响应时间确定常驻进程区间。
- 选择管理模式:流量平稳选 static,波动大选 dynamic,低频任务可考虑 ondemand。
- 配置
max_requests周期回收进程,观察 status 与内存变化调整。
代码或图示
// 文档示例:dynamic 模式参数方向(数值按内存压测确定,待确认)
// pm = dynamic
// pm.max_children = 32
// pm.start_servers = 8
// pm.min_spare_servers = 4
// pm.max_spare_servers = 12
// pm.max_requests = 500
// 估算:max_children × 单进程内存 ≤ 预留给 PHP 的内存上限
常见误区
- max_children 按 CPU 核数拍脑袋:主要约束是内存,不是核数;进程过多导致换页与上下文切换。
- 不设 max_requests:常驻进程累积内存泄漏,长期运行后 OOM。
追问
- ondemand 适合什么场景?答:低频、请求量小的后台或任务机;高并发场景 fork 延迟会直接体现在首响上。
- 进程池打满看哪个指标?答:status 页 active 达到 max_children、排队请求与
max children reached记录。
06.5.8.10-013 一个 FPM worker 处理请求的生命周期是怎样的?
一句话结论
worker 从进程池获取 FastCGI 请求 → 初始化 PHP 请求上下文 → 执行入口脚本与框架引导 → 输出响应 → 回收请求内变量与连接 → 回到空闲状态等待下一个请求。
概念解释
FPM worker 常驻复用,每个请求独立初始化与释放作用域;请求结束后请求级变量销毁,但进程内静态缓存、全局对象与持久连接可能保留。理解生命周期有助于判断内存泄漏位置:是请求内未释放,还是进程级缓存持续增长。OPcache 等运行时缓存跨请求保留,属于运行时优化而非请求内数据。
原理流程
- 监听 socket 上的新请求,worker 被调度处理。
- 解析 FastCGI 参数,初始化
$_SERVER/$_GET/$_POST等超全局。 - 执行脚本,框架完成路由、业务与响应输出。
- 请求结束清理请求资源;进程按
max_requests或内存水位决定是否重启。
代码或图示
// 文档示例:请求内资源释放关注点
// - 请求级:局部变量、临时对象、查询结果,请求结束自动销毁
// - 进程级:static 变量、单例、持久连接,跨请求保留,需评估增长
// - 每个请求结束后检查:是否有静态数组只增不减、连接未关闭
// 本机为 CLI 环境,FPM 生命周期行为以实际 FPM 进程实测为准
常见误区
- 以为请求结束进程内所有数据都清空:进程级静态状态跨请求保留,可能累积脏数据。
- 在请求间用 static 保存业务上下文:多请求复用导致串数据,应放入请求上下文或缓存服务。
追问
- 持久连接在 worker 复用时怎么处理?答:连接随进程保留,需设置空闲超时与断开重连;避免空闲连接堆积。
- 框架引导开销如何跨请求摊薄?答:依赖 OPcache 与框架编译缓存;请求内仍需完成路由与容器初始化。
06.5.8.10-014 FPM status 页暴露哪些关键指标?
一句话结论
status 页提供进程池汇总:已监听队列、活跃/空闲进程数、达到最大子进程次数、请求数与慢日志计数;用于判断进程池是否打满、伸缩是否合理与慢请求规模。
概念解释
启用 FPM status 路由后,可按 HTML 或 JSON/纯文本查看池状态。核心字段包括 accepted conn、listen queue、active processes、idle processes、max children reached、slow log 计数。指标要结合 Nginx 与下游指标一起看,单看进程数无法定位根因。具体字段名与默认开关以版本为准,待确认。
原理流程
- 在 FPM 配置启用 status 路径,并在 Nginx 暴露或内网访问该路径。
- 采集活跃/空闲进程、监听队列与 max children reached 计数。
- 持续记录请求量与慢日志计数,观察伸缩趋势。
- 按积压与内存数据调整进程数与管理模式。
代码或图示
// 文档示例:status 配置与采集方向
// fpm.conf: pm.status_path = /fpm-status
// nginx: location = /fpm-status { allow 内网; deny all; fastcgi_pass fpm:9000; }
// 采集字段:active processes / idle processes / listen queue /
// max children reached / slow requests
// 待确认:字段名称与输出格式以 FPM 版本为准
常见误区
- 把 status 暴露到公网:泄露进程池与路径信息,应限制内网或认证访问。
- 只看活跃进程数:配合空闲进程、队列与慢请求计数才能判断健康度。
追问
listen queue持续增长说明什么?答:进程池处理不过来,请求在队列等待;需扩容或优化处理速度。max children reached累计增加说明什么?答:多次打满进程池,当前上限或处理能力不足。
06.5.8.10-015 FPM 慢日志与 PHP 慢执行如何配合排查?
一句话结论
FPM 慢日志记录执行超过 request_slowlog_timeout 的 worker 堆栈,PHP 错误日志记录脚本异常与告警;两者配合定位慢脚本位置,再下钻到具体下游依赖。
概念解释
慢日志在脚本执行超阈值时转储当前调用栈,能指出卡在哪段代码;PHP 错误日志记录警告、致命错误与未捕获异常。慢不等于报错:慢可能是等待数据库、外部接口、锁或 IO。排查时先从慢日志堆栈定位代码段,再看下游耗时指标。日志路径与阈值配置在 fpm.conf 与 php.ini 中,待确认。
原理流程
- 设置慢日志阈值,收集超阈值请求的调用栈。
- 按脚本路径与堆栈热点聚合慢请求分布。
- 对照 PHP 错误日志与下游指标,区分代码慢、等待慢还是资源竞争。
- 优化后复测慢日志计数与接口耗时。
代码或图示
// 文档示例:慢日志配置方向(阈值按接口耗时分布设定,待确认)
// fpm.conf: request_slowlog_timeout = 10s
// fpm.conf: slowlog = /var/log/php-fpm/slow.log
// php.ini: error_log = /var/log/php/error.log
// 慢日志堆栈示例(文档描述):调用帧指向控制器 → 服务 → 下游调用
常见误区
- 慢日志阈值设得过小:正常慢接口也被记录,噪音淹没真正问题。
- 只看耗时不看堆栈:无法判断慢点在业务代码还是下游等待。
追问
- 慢日志能记录正在执行的 SQL 吗?答:它记录 PHP 调用栈,SQL 文本需结合数据库慢查询日志与请求 trace 关联。
- 进程被
request_terminate_timeout终止记在哪里?答:FPM 错误日志与系统记录,区别于慢日志的堆栈转储。
06.5.8.10-016 为什么 PHP 用 FastCGI 转发而不是 proxy_pass 反向代理?
一句话结论
PHP-FPM 只监听 FastCGI 协议,不提供 HTTP 服务,因此 Nginx 用 fastcgi_pass 转发;proxy_pass 用于把 HTTP 请求转发给另一个 HTTP 后端服务,两者协议与参数体系不同。
概念解释
FastCGI 是常驻进程与 Web 服务器之间的协议,参数以环境变量形式传递脚本路径与请求元数据;HTTP 反向代理转发完整 HTTP 请求与响应头。架构中若 PHP 业务包了一层 HTTP 服务(如常驻 Web 框架),才用 proxy_pass;传统 FPM 部署必须走 FastCGI。混用两种转发方式会出现协议错误。
原理流程
- 判断后端暴露的协议:FPM 是 FastCGI,HTTP 服务是 HTTP。
- FastCGI 转发配置
fastcgi_pass与 fastcgi 参数。 - HTTP 转发配置
proxy_pass与 proxy 头(Host、X-Forwarded-*)。 - 跨服务部署时核对监听协议与端口,避免协议错配。
代码或图示
// 文档示例:两种转发对比
// FastCGI(php-fpm):
// fastcgi_pass fpm:9000;
// fastcgi_param SCRIPT_FILENAME ...;
// HTTP 后端(其他 Web 服务):
// proxy_pass http://backend:8080;
// proxy_set_header Host $host;
// proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
常见误区
- 对 FPM 地址用
proxy_pass:协议不匹配,返回无效响应或 502。 - 对 HTTP 后端用
fastcgi_pass:参数体系不兼容,后端无法解析请求。
追问
- X-Forwarded-* 头在哪一层设置?答:HTTP 反向代理层设置;FastCGI 场景通过 fastcgi_param 传递客户端信息。
- 后端获取真实 IP 怎么配?答:代理层传递头,应用层按可信代理链解析。
06.5.8.10-017 Nginx 如何设置静态资源与响应的缓存头?
一句话结论
静态资源用 expires 与 Cache-Control 控制浏览器与中间缓存有效期,配合 ETag/Last-Modified 做条件请求;动态接口按不缓存或短缓存策略单独设置。
概念解释
expires 生成 Expires 与 Cache-Control: max-age;带内容哈希的静态资源可长缓存并标记 immutable;未哈希资源更新频繁,缓存期要短。条件请求由 Nginx 校验文件时间戳或生成 ETag,未修改返回 304。动态响应默认不缓存,鉴权与个性化数据禁止公开缓存。
原理流程
- 区分静态资源与动态接口,分别定义缓存策略。
- 静态目录配置过期时间与缓存头,开启条件请求校验。
- 动态接口按语义设置
Cache-Control: no-store或私有短缓存。 - 上线发版后核对静态资源 URL 版本变化,避免旧缓存残留。
代码或图示
// 文档示例:缓存头方向
// location ~* \.(css|js|png|jpg|svg|woff2)$ {
// expires 30d;
// add_header Cache-Control "public";
// }
// 动态接口:add_header Cache-Control "no-store, private";
// 条件请求:Nginx 按文件 mtime 处理 If-Modified-Since;ETag 行为以版本为准
常见误区
- 对带用户数据的接口设公开长缓存:多用户共享缓存导致串数据。
- 无哈希静态资源设超长缓存:发版后用户拿到旧文件。
追问
- immutable 是什么含义?答:告知浏览器资源在缓存期内不会变更,无需条件校验;只适用于内容哈希文件名资源。
- 304 怎么产生?答:客户端带条件请求头,Nginx 校验资源未变后返回 304 与空响应体。
06.5.8.10-018 Nginx 在 HTTPS 与压缩上承担什么职责?
一句话结论
Nginx 通常作为 TLS 终止层处理证书、握手与 HTTPS 配置,并承担 gzip/Brotli 等响应压缩;后端 FPM 只处理业务内容,不直接面对浏览器 TLS。
概念解释
证书部署在入口 Nginx,浏览器到 Nginx 加密传输,Nginx 到内网后端可按网络环境走明文或内部加密。压缩在出口层对文本类响应统一处理,减少后端重复压缩逻辑。HTTP 到 HTTPS 的跳转、HSTS 头等策略也在入口配置。证书有效期与续期需纳入运维检查。
原理流程
- 证书与私钥配置在 Nginx 站点,监听 443 并配置协议套件。
- 浏览器完成 TLS 握手,明文或内网加密转发后端。
- 响应在出口按 MIME 类型压缩后返回。
- 定期检查证书有效期与加密配置基线。
代码或图示
// 文档示例:HTTPS 与压缩职责划分(具体套件与压缩级别待确认)
// 入口 Nginx:listen 443 ssl; ssl_certificate / ssl_certificate_key; gzip on;
// 内网 FPM:只监听内网地址,不直接暴露公网
// 后端应用:不感知 TLS,按内部协议处理请求
常见误区
- 证书私钥随代码入库:私钥应走部署机密管理,仓库中不保存。
- 对内网后端也强制假设链路已安全:内网隔离与加密策略需按安全规范评估。
追问
- 压缩对图片等二进制有必要吗?答:已压缩格式收益小,应按 MIME 类型选择是否压缩。
- TLS 终止后后端怎么拿到协议信息?答:通过转发头与参数传递原始协议、主机与客户端信息。
06.5.8.10-019 线上 502/504 的标准排查顺序是什么?
一句话结论
先看 Nginx error.log 区分错误类型与超时阶段,再查 FPM status 与错误日志判断进程池状态,接着定位慢脚本与下游依赖,最后核对配置路径、权限与资源水位,形成从入口到后端的闭环。
概念解释
排查顺序遵循链路从上到下:入口连通性 → 进程池负载 → 脚本执行 → 下游依赖。每一步都要有日志或指标证据,不凭猜测改配置。复现问题时记录请求时间、trace_id 与接口路径,便于跨日志关联。
原理流程
- 收集报错时间、接口、状态码与 Nginx error.log 条目。
- 检查 FPM 进程是否存活、监听地址是否正确、status 是否打满。
- 查 FPM 慢日志与 PHP 错误日志,定位脚本与异常。
- 下钻数据库、Redis、外部接口耗时;核对内存、磁盘与连接资源。
- 修复后复测错误率与慢请求计数。
代码或图示
// 文档示例:排查记录模板
// 时间 / 接口 / 状态码 / Nginx 报错摘要
// FPM: active=? idle=? listen_queue=? max_children_reached=?
// 慢日志: 脚本与调用栈
// 下游: DB 耗时 / 外部接口耗时 / Redis 命令耗时
// 结论: 根因层级(连通性/进程池/脚本/下游/资源)与处理动作
常见误区
- 跳过日志直接重启服务:现象恢复但根因未明,问题反复出现。
- 只看应用报错日志:502/504 往往在应用日志之前就已发生,必须先看入口与 FPM 日志。
追问
- 间歇性 502 怎么抓证据?答:先加错误率监控与采样日志,复现时保留 Nginx/FPM/系统三类日志片段。
- 修复后如何验证?答:观察错误率、进程池水位与慢请求计数回落,对比修复前后指标。
06.5.8.10-020 Nginx + FPM 部署配置有哪些易踩的坑?
一句话结论
常见坑包括脚本路径拼接错误、静态目录可解析 PHP、socket 权限不当、超时与缓冲配置失衡、上传临时目录不可写、真实 IP 未透传、配置改动未校验即 reload。
概念解释
配置类问题多为路径、权限与规则遗漏。上线前应做配置语法校验,逐环境核对文档根目录、监听地址、目录权限与上传限制。站点配置与部署目录保持一致,避免多环境复制粘贴导致路径漂移。
原理流程
- 部署前核对
root、SCRIPT_FILENAME、FPM 监听与 socket 路径。 - 检查静态目录 PHP 解析关闭、上传临时目录可写、运行用户一致。
- 校验配置语法,再 reload;先灰度观察错误日志与 status。
- 整理配置清单纳入交付检查项,避免环境间漂移。
代码或图示
// 文档示例:上线前核对清单
// [ ] root / SCRIPT_FILENAME 与部署目录一致
// [ ] fastcgi_pass 地址(TCP/socket)与 FPM 监听一致
// [ ] 静态目录禁止解析 .php
// [ ] 上传临时目录存在且可写,大小限制两层一致
// [ ] 超时、缓冲、进程池参数按压测值配置
// [ ] nginx -t 语法通过后再 reload
常见误区
- 改完配置直接 reload 生产:语法错误会导致 reload 失败或站点异常,应先校验。
- 开发环境配置复制到生产:路径、域名、上传上限与证书差异未核对。
追问
- 配置校验命令是什么?答:Nginx 提供测试配置命令,具体调用方式以部署环境 Nginx 版本为准;通过后再执行 reload。
- 多站点共用 FPM 要注意什么?答:各站点脚本路径隔离,进程池与用户按部署规范划分,避免跨站点文件访问。