Hyperf定时任务大内存文件处理进程内存泄漏解决-php教程-PHP中文网

hyperf定时任务处理大文件易致内存缓慢上涨并oom，核心在于协程模型下资源未释放：需游标式读取、禁用pdo缓冲、显式释放变量与句柄、避免闭包强引用、精简日志、主动触发gc及拆分任务。

hyperf定时任务大内存文件处理进程内存泄漏解决

Hyperf 定时任务在处理大文件（如 CSV 解析、日志归档、Excel 导出等）时，若未控制内存生命周期，极易引发缓慢但持续的内存上涨，最终触发 OOMKilled。这不是单次执行崩溃，而是协程常驻进程内对象累积、资源未释放导致的“慢性泄漏”。关键不在文件大小本身，而在处理方式是否适配协程模型。

关闭缓冲 + 游标式逐行读取

大文件读取最常见误区是：用 file_get_contents 一次性加载全文，或用 fgetcsv 配合全量数组缓存。Hyperf 中更隐蔽的是 ORM 或 DB 查询返回结果集后调用 toArray() 或 json_encode() —— 即使只查 1 行，若底层 SQL 关联了百万级明细，PDO 默认缓冲会把整张结果集载入内存。

数据库操作务必禁用 PDO 缓冲：'options' => [PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false]
改用 Db::query()->cursor()（Hyperf 3.x+），或底层 fetch() 循环，确保每次只持有单行数据
避免 get()、all()、paginate() 等批量获取方法；若必须分页，用游标分页（cursorPaginate）而非 offset 分页

显式释放中间变量与资源句柄

定时任务运行在 Worker 进程内，生命周期与进程一致。PHP GC 不会自动清理未 unset 的大数组、临时对象或打开的文件句柄，尤其在 while 循环中反复追加数据时。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

每轮处理完一批数据后，主动 unset($batchData)、$batchData = []
使用 fopen() 读取文件时，循环结束后必须 fclose($fp)；推荐用 yield from + Generator 实现流式解析，天然规避内存堆积
对大对象（如 Excel Reader 实例、ZipArchive）使用后立即 unset，不要依赖作用域自动销毁

避免闭包捕获与全局容器强引用

定时任务方法内若定义匿名函数并 use 了 $container、$db 或大型数据结构，该闭包会延长这些对象的生命周期，导致整个 Worker 进程无法回收它们。

禁止在 @Cron 方法中写 $fn = function() use ($container) { ... };
需要容器服务时，延迟到 handle() 或循环体内按需获取：$logger = $this->container->get(LoggerInterface::class)
日志记录禁止传入 $this、$container 或原始数据对象，改用精简数组：['file_size' => $size, 'lines' => $count]