Ubuntu 上预防 PHP-FPM 内存泄漏的实用方案
一 预防原则与进程管理
- 利用 PHP-FPM 的请求生命周期，在请求结束时由 php_request_shutdown 统一释放内存；在 FPM 模式下“泄漏”多表现为进程驻留内存随请求数逐步上升，因此要通过进程管理把“增长”关在可控范围内。
- 配置进程池的回收策略：将 pm.max_requests 设为每个子进程在处理一定数量的请求后自动重启（如 500），以对冲未知泄漏与第三方扩展累积的内存；同时合理设置 pm、pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers，避免并发过高导致总内存超出物理内存。
- 选择适合的进程管理模式：并发波动大可用 dynamic，资源紧张或间歇性流量可用 ondemand，以降低常驻进程数量。
- 设置脚本最大执行时间 request_terminate_timeout（如 30s），防止异常请求长时间占用进程。
- 启用 catch_workers_output = yes，便于把子进程日志纳入主日志，及时发现异常。
- 示例（路径按实际版本调整，如 /etc/php/8.1/fpm/pool.d/www.conf）：
- pm = dynamic
- pm.max_children = 50
- pm.start_servers = 5
- pm.min_spare_servers = 5
- pm.max_spare_servers = 35
- pm.max_requests = 500
- request_terminate_timeout = 30s
- catch_workers_output = yes
以上做法能在泄漏未修复前，显著降低其对生产的影响。
二 PHP 运行环境与代码层面的预防
- 启用并合理配置 OPcache（生产建议开启），减少重复编译带来的内存与 CPU 开销：
- opcache.enable=1
- opcache.memory_consumption=128
- opcache.interned_strings_buffer=8
- opcache.max_accelerated_files=4000
- opcache.revalidate_freq=60
- 避免把请求级数据放入长生命周期容器：不要向 静态属性、全局变量 $GLOBALS、函数静态变量持续追加数据；注意 循环引用与对象间引用导致的回收不完全，必要时在请求结束前 unset 大对象或解除引用。
- 及时释放资源：关闭文件句柄、数据库连接、缓存连接等，并在异常分支中也确保释放。
- 控制单次请求的内存峰值：避免一次性加载超大结果集，分页/流式处理大文件，及时 unset 不再使用的临时变量，减少不必要的变量拷贝。
- 谨慎在生产启用调试扩展（如 Xdebug），其会显著增加内存占用与开销。
- 保持 PHP、PHP-FPM 与扩展为稳定新版本，及时获得修复与优化。
三 监控 告警与快速处置
- 实时监控进程内存：使用 htop 按内存排序（Shift + M）定位异常进程；结合 php-fpm status 页面观察进程状态与吞吐。
- 打开 slowlog，记录执行时间过长的请求，配合应用日志定位问题代码路径。
- 建立基础告警：当 可用内存或 单个 FPM 子进程 RSS超过阈值时触发告警，防止雪崩。
- 不建议用粗暴的“定时 kill 进程”兜底，优先依靠 pm.max_requests 的周期性回收；若必须兜底，应设定安全阈值与最小存活数，避免影响正在处理的请求。
四 定位泄漏的常用工具与方法
- 开发/测试环境用 Valgrind 对脚本进行内存检测：
- valgrind --leak-check=full php your_script.php
可输出详细泄漏报告，辅助定位问题代码或扩展。
- 使用 Xdebug 生成函数调用跟踪与内存使用报告，配合分析请求内内存增长点（生产慎用，开销大）。
- 结合 php-fpm status、slowlog、应用日志与系统监控，形成“现象—请求—代码路径”的闭环定位。
五 容量规划与配置核算
- 预估总内存占用：总内存 ≈ pm.max_children × 平均每个子进程常驻内存 × 安全系数。例如：max_children=50、每进程常驻约 40MB、安全系数 1.2，则常驻基线约 2.4GB；再叠加峰值与缓存，为系统留出充足余量。
- 结合业务并发与脚本内存峰值，合理设置 pm.max_children 与 pm.max_requests；并发高但泄漏轻微可适当增大 max_children，泄漏风险高则降低 max_children 并提高 max_requests 的回收频率。