PHP内存泄漏怎么排查

wen PHP项目 2026-08-11 159

本文目录导读：

PHP内存泄漏怎么排查

理解 PHP 内存模型
定位泄漏的 6 个步骤
常见泄漏场景与修复方案
生产环境监控方案
预防泄漏的最佳实践
快速诊断命令汇总
总结排查流程

PHP 内存泄漏排查是一个系统性的过程，需要结合工具、代码审查和监控，以下是一套完整的排查指南：

理解 PHP 内存模型

首先明确：PHP 的“内存泄漏”通常是“内存峰值过高”，因为 PHP-FPM 每个请求结束后会释放大部分内存（进程回收），真正的问题往往出现在：

长驻进程（如 swoole、workerman、队列消费者）
单次请求处理数据量过大
循环引用未清理
全局变量/静态变量累积

定位泄漏的 6 个步骤

步骤1：确认是否存在泄漏

# 监控单进程内存（持续观察）
while true; do ps -o rss,pmem,cmd -p $(pgrep -f "php-fpm: pool" | head -1); sleep 5; done
# 批量查看所有 PHP 进程内存
ps aux | grep php | awk '{print $2, $6/1024"MB", $11}'

步骤2：启用内存检测工具

Xdebug + 内存分析：

// 在脚本中分段记录
$usage = memory_get_usage();
// ...业务代码...
echo "操作A后: " . (memory_get_usage() - $usage) . " bytes\n";

使用 PHP 内置函数定位：

class MemoryTracker {
    private static $markers = [];
    public static function mark($label) {
        self::$markers[$label] = [
            'usage' => memory_get_usage(true),
            'peak'  => memory_get_peak_usage(true),
            'time'  => microtime(true)
        ];
    }
    public static function report() {
        $prev = null;
        foreach (self::$markers as $label => $data) {
            $diff = $prev ? $data['usage'] - $prev['usage'] : 0;
            echo "$label: 使用{$data['usage']} bytes, 增长{$diff} bytes\n";
            $prev = $data;
        }
    }
}

步骤3：使用 Valgrind 定位 C 层面泄漏

# 安装
apt-get install valgrind
# 运行 PHP 脚本（需编译 PHP 时支持）
valgrind --tool=memcheck --leak-check=full \
         --show-leak-kinds=all \
         --log-file=valgrind.log \
         php your_script.php

步骤4：检查 PHP 扩展泄漏

# 逐个禁用扩展测试
php -d extension_dir=/usr/lib/php/20210902 -n your_script.php
# 通过 php-fpm 日志确认
php-fpm -t 2>&1 | grep -i memory

步骤5：代码审查重点区域

// 高危模式1：静态/全局变量累积
class Cache {
    private static $items = []; // 永不释放
    public static function set($key, $value) {
        self::$items[$key] = $value; // 如果无限增长，就是泄漏
    }
}
// 高危模式2：大数据量循环处理
$data = DB::select("SELECT * FROM huge_table");
foreach ($data as $row) {
    // 处理但未清除引用
}
// 高危模式3：闭包捕获
$result = [];
for ($i = 0; $i < 100000; $i++) {
    $closure = function() use ($result) { // 捕获整个 $result
        // 逻辑...
    };
    $result[] = $closure; // 每个闭包都带一份 $result 引用
}
// 高危模式4：长连接未复用
foreach ($items as $item) {
    $conn = new PDO(...); // 每次新建连接
    // 用完未关闭/释放
}

步骤6：专门工具分析

Blackfire.io（可视化分析）

# 安装黑火监控
# 在代码中添加埋点
blackfire_set_transaction_name("check_memory");
// 业务代码...
blackfire_end_transaction();

Tideways（生产环境分析）

自定义简单监控脚本：

// 每 100 次迭代检查一次
$startMemory = memory_get_usage();
for ($i = 0; $i < 1000000; $i++) {
    processItem($i);
    if ($i % 1000 == 0) {
        $current = memory_get_usage();
        $diff = $current - $startMemory;
        if ($diff > 10 * 1024 * 1024) { // 超过 10MB
            echo "可能的泄漏在迭代 $i: {$diff} bytes\n";
            debug_print_backtrace();
        }
    }
}

常见泄漏场景与修复方案

场景1：循环引用导致泄漏

// 问题代码
class A { public $b; }
class B { public $a; }
$a = new A();
$b = new B();
$a->b = $b;
$b->a = $a; // 循环引用
// 修复：使用弱引用（PHP 7.4+）
$a->b = WeakReference::create($b);

场景2：Generator/Iterator 未销毁

// 问题代码
$generator = getHugeData(); // 返回 generator
foreach ($generator as $item) {
    // 中途跳出循环
    if ($condition) break; // generator 被保留，资源未释放
}
// 修复：手动调用 close
finally {
    $generator->close();
}

场景3：文件/资源句柄未关闭

// 问题代码
foreach ($files as $file) {
    $handle = fopen($file);
    // 忘记 fclose()
}
// 修复：使用 try-finally 或 using 块
foreach ($files as $file) {
    $handle = fopen($file);
    try {
        // 处理逻辑
    } finally {
        fclose($handle);
    }
    // 或者使用自动关闭的包装器
    $content = file_get_contents($file); // 自动关闭
}

生产环境监控方案

添加内存监控指标到应用

// 在应用框架的 after-middleware/事件中
class MemoryMonitor {
    public function __construct() {
        $this->baseline = memory_get_usage();
    }
    public function __destruct() {
        $used = memory_get_peak_usage() - $this->baseline;
        if ($used > 50 * 1024 * 1024) { // 50MB 告警
            error_log("高内存使用: " . formatBytes($used));
        }
    }
}

使用云监控工具

# Prometheus + Grafana 配置示例
php_memory_usage_bytes{process="php-fpm"} 
php_memory_peak_usage_bytes{process="php-fpm"}

预防泄漏的最佳实践

使用依赖注入容器而不是全局/静态实例
避免循环引用：序列化数组时使用 serialize/unserialize 断开引用
大数据量操作分页：不要一次加载全部数据
定期重启长驻进程：设置合适的内存上限自动重启
代码规范检查：使用 PHPStan/Psalm 静态分析工具

快速诊断命令汇总

# 快速查看最大内存占用的 PHP 进程
ps aux --sort=-rss | grep php | head
# PHP 脚本中实时监控
php -r 'echo ini_get("memory_limit");'
# 查看是否有未释放的 MySQL/Redis 连接
ss -tlnp | grep php-fpm
# 使用 PHP7+ 的内置检测
php -d display_errors=1 -d error_reporting=E_ALL -d opcache.enable=0 -d `php -d opcache.enable_cli=1 -d opcache.validate_timestamps=0` -r 'echo memory_get_usage();'

总结排查流程

确认内存持续增长（观察多次请求/循环内存变化）
2. 使用 memory_get_usage 分段定位（二分法找泄漏点）
3. 结合 Valgrind 排除扩展问题
4. 代码审查 + xdebug profile 分析
5. 实施修复并验证（监控回归）

关键点：先确认是不是真泄漏，再定位泄漏位置，最后修复和验证，工具只是辅助，最重要的还是理解代码中对内存引用的生命周期管理。

本文地址： https://bmjup.com/post/43952.html