Ubuntu PHP-FPM的内存泄漏怎么预防

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 的回收频率。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！