CakePHP 2.10 循环调用Cache::read()出现内存泄漏问题求解决方案

1. 清理CakePHP缓存组件内置静态缓存（优先处理） #

CakePHP的文件缓存引擎默认会将所有已读取的缓存项存入内部静态数组，做请求内二次读取优化，这部分内存属于活跃引用，普通垃圾回收无法清理，是内存持续上涨的核心原因。可在每轮循环读取缓存后手动清理该静态缓存：

$data = Cache::read($cache_key, $cache_config);
// 业务逻辑处理$data

// 清理对应缓存引擎的内部静态缓存
$cacheEngine = Cache::engine($cache_config);
$ref = new ReflectionClass($cacheEngine);
// CakePHP 3.x/4.x文件引擎的静态缓存属性名为$_cache，旧版本可对应调整
$cacheProp = $ref->getProperty('_cache');
$cacheProp->setAccessible(true);
$cacheProp->setValue($cacheEngine, []);

// 销毁当前数据变量
$data = null;
unset($data);
gc_collect_cycles();

2. 绕过缓存组件直接读取缓存文件 #

如果不想修改缓存引擎的内部属性，可直接读取缓存文件反序列化，避免组件内部的内存累积：

// 从缓存配置中获取缓存文件存储路径
$cachePath = Cache::engine($cache_config)->config('path') . $cache_key;
if (file_exists($cachePath)) {
    $data = unserialize(file_get_contents($cachePath));
    // 业务处理完成后直接销毁变量即可，无额外内存残留
}

3. 批量任务层面规避内存泄漏 #

• 关闭调试模式：调试模式下CakePHP会存储每一次缓存操作、SQL查询的日志，会额外占用大量内存，批量任务执行前务必关闭debug配置。
• 分批进程处理：如果是CLI脚本执行任务，可调整为每处理20~30份CSV就退出当前进程，启动新进程处理下一批，从根源上避免单进程内存累积。
• 排查业务逻辑中的隐藏内存占用：检查调用的模型方法是否存在静态属性存储数据、事件回调未注销、日志持续写入的逻辑，每轮循环结束后同步清理这部分残留数据。

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