Ubuntu下PHP内存泄漏的定位与修复
一 快速判断与现场信息收集
遇到PHP内存泄漏，先别急着翻代码。先做这几件事，能帮你快速锁定问题范围。
- 首先，用htop或top瞄一眼系统内存，按Shift+M按内存排序，看看PHP-FPM子进程的内存是不是跟着请求一路飙升。找到那个“显眼包”。
- 接着，翻翻日志。/var/log/php-fpm.log、nginx或apache的error log，用关键字“Allowed memory size of X bytes exhausted”或者“Fatal error”一搜，就能定位到是哪个脚本、哪个URL出了问题。
- 或者，直接在脚本里埋点，用memory_get_usage()和memory_get_peak_usage()打印内存，看看是哪一段代码让内存蹭蹭往上涨。
- 需要提醒的是，你得先分清楚，这是真的“泄漏”，还是单纯的“高占用”。如果只是单次请求处理了大文件，那不一定算泄漏；真正的泄漏，是多次请求之后，内存压根不回落，甚至持续攀升。
二 常见根因
搞清楚了现象，再来说说常见的“肇事者”。
- 循环引用：对象A里有B，B里又有A，互相嵌套，引用计数永远不为零，GC也没法回收。解决办法就是打破循环，或者显式清理。
- 全局/静态变量：这些变量生命周期贯穿整个进程，在长脚本或常驻进程里特别容易积累，一点点堆起来。
- 未释放的资源：文件句柄、数据库连接、redis连接，用完不关，就像水龙头不关，迟早泛滥。
- 第三方扩展或库的缺陷：有些扩展本身就有内存泄漏的bug，升级或换一个库往往就能解决。
- 一次性加载大数据：把整个大文件或大结果集一次性读进内存，分分钟触发OOM，或者看起来像泄漏，其实只是压力太大。
三 定位方法
知道了原因，怎么精准定位到具体代码？这几个方法很实用。
- 代码埋点对比：在关键步骤前后打印memory_get_usage()，差值一算，增长点一目了然。
- Xdebug分析：开启trace或var_dump，配合引用跟踪，能帮你发现对象为什么没被释放，循环引用路径在哪。
- Valgrind：优先对CLI脚本用valgrind --leak-check=full php your_script.php，能拿到详细的泄漏报告。如果是FPM环境，可以先设置pm.max_requests让子进程每N请求重启，隔离问题，再在CLI环境下复现定位。
- 长驻进程：对于守护进程，可以用/proc/
/status里的VmRSS字段，观察内存是否持续增长，确认是不是真的泄漏。
四 修复与优化清单
定位到问题后，修复手段其实很明确，按这个清单来就行。
- 打破循环引用：对象不再需要时，把互相引用的属性置为null，或者在__destruct里清理引用，给GC一点帮助。
- 及时释放资源：fclose()、数据库连接、缓存连接，都要确保在finally块或异常分支里也能正常关闭，别留后患。
- 减少全局/静态变量：缩小作用域，别在大容器里无限制地堆积状态。
- 避免一次性加载大数据：用生成器(yield)、分块读取、分页查询、流式处理，把峰值内存降下来。
- 主动触发GC：在长循环或批处理结束时，调用gc_collect_cycles()，把循环引用残留清理掉。
- 升级依赖：更新PHP版本、第三方库、扩展，很多已知泄漏在新版本里已经修复了。
五 PHP-FPM与运行环境的稳妥配置
代码层面的修复搞定了，再从环境配置上补一刀，双重保险。
- 控制进程生命周期：设置pm.max_requests = 500，或者根据压测结果调整，让子进程处理一定请求后自动重启，不让泄漏累积。
- 合理进程池：根据内存和并发量调整pm.max_children，别让进程数太多，直接把物理内存撑爆。
- 启用OPcache：在php.ini里开启并合理配置，减少重复编译，降低内存和CPU压力。
- 调整脚本上限：memory_limit只在必要时提高，优先通过代码和架构优化来降低内存需求。
- 精简扩展：生产环境里禁用不必要的扩展，比如Xdebug，减少额外开销。
- 持续监控：用htop和日志巡检，看看重启后内存是否能回落到基线，确认问题是否彻底解决。
六 最小可行修复示例
最后，看一个最小可行修复示例。场景是两个对象互相引用，导致无法回收。修复方法是在销毁时显式打破循环引用。
class A {
public $b;
public function __construct() {
$this->b = new B();
$this->b->a = $this; // 形成循环引用
}
public function __destruct() {
// 打破循环引用，帮助GC回收
if ($this->b) {
$this->b->a = null;
}
}
}
class B {
public $a;
}
// 使用
$a = new A();
// ... 使用完毕
unset($a); // 触发析构，打破循环引用后可被回收以上步骤，从快速判断到定位修复，再到环境配置，形成了一个完整的闭环。既能解决真正的泄漏，也能优化高内存占用的代码与架构。
