PHP垃圾回收机制理解与CakePHP内存释放问题排查

问题场景 #

此前未接触PHP垃圾回收机制，运行CakePHP 5.x命令脚本时遇到内存耗尽问题。为测试内存清理方法，编写了以下代码：

$connection = ConnectionManager::get('default');
$this->logMessage('Memory usage before query: ' . memory_get_usage(true) / 1024 / 1024 . 'MB');
$studentList = $connection->execute("SELECT DISTINCT
            stu.STU_ID AS person_id
    FROM SMS.S1STU_DET AS stu
    LEFT JOIN Pulse.$studentsTableName AS students
        ON students.person_id = stu.STU_ID
    LEFT JOIN Pulse.$coursesTableName AS courses
        ON courses.person_id = stu.STU_ID
    LEFT JOIN Pulse.$unitsTableName AS units
        ON units.person_id = stu.STU_ID
    LEFT JOIN Pulse.$rawCasesTableName AS cases
        ON cases.person_id = stu.STU_ID
    WHERE   1 = 1
        AND (
            students.person_id IS NOT NULL
            OR
            courses.person_id IS NOT NULL
            OR
            units.person_id IS NOT NULL
            OR
            cases.person_id IS NOT NULL
        )
")->fetchAll('assoc');

$this->logMessage('Memory usage after query: ' . memory_get_usage(true) / 1024 / 1024 . 'MB');

unset($studentList);
gc_collect_cycles();

$this->logMessage('Memory usage after garbage collection: ' . memory_get_usage(true) / 1024 / 1024 . 'MB');
exit();

运行后输出：

2025-02-23 11:32:54 - Memory usage before query: 8MB
2025-02-23 11:32:57 - Memory usage after query: 48MB
2025-02-23 11:32:57 - Memory usage after garbage collection: 44MB

可见调用gc_collect_cycles()后内存无法回到初始的8MB左右，无论是否调用该函数，内存都会降至44MB。

问题原因与解决方法 #

1. 先搞懂memory_get_usage(true)的含义 #

你看到的44MB是PHP向系统申请的内存块总大小，不是实际正在使用的内存。PHP的内存管理机制是：当内存被释放后，不会立刻把内存还给操作系统，而是保留下来供后续代码复用，所以memory_get_usage(true)的数值不会立刻降到初始值。

如果想查看实际使用的内存，可以打印memory_get_usage(false)：

$this->logMessage('实际使用内存 after GC: ' . memory_get_usage(false) / 1024 / 1024 . 'MB');

这个值应该会明显下降，说明垃圾回收其实已经生效了。

2. 解决内存耗尽的核心方案：分批处理数据 #

一次性用fetchAll()把所有数据加载到内存是导致内存暴涨的根本原因。改用CakePHP的**游标（Cursor）**逐行处理，内存只会保留当前行的数据：

$query = $connection->execute("你的SQL语句");
// 用cursor()迭代处理每一行
foreach ($query->cursor() as $row) {
    // 处理单条student数据
    // 比如：$this->processStudent($row['person_id']);
}

这种方式内存占用会一直维持在较低水平，从根源上避免内存耗尽。

3. 额外的内存释放技巧 #

• 除了unset($studentList)，可以尝试释放数据库连接对象，再重新获取：

unset($studentList);
unset($connection);
gc_collect_cycles();
// 后续需要使用时重新获取连接
$connection = ConnectionManager::get('default');

• 检查代码中是否有全局变量、静态变量持有数据引用，这些会导致垃圾回收无法释放内存。

4. 临时应急方案：调高内存限制 #

如果必须一次性处理所有数据，可以临时调高PHP内存限制，但这只是治标不治本：

// 在脚本开头设置
ini_set('memory_limit', '256M');

内容的提问来源于stack exchange，提问作者guyverdio