PhpSpreadsheet解析2.5万条记录Excel报500错误及内存超限问题咨询

结论 #

该问题不属于预期情况，是代码实现存在多处可优化点导致的，2.5万行级别的Excel解析任务用PhpSpreadsheet完全可以在常规服务器配置下稳定运行。

现存代码的核心问题 #

• 内存堆积未释放：每读取20行数据就重新加载一次Excel文件，处理完当前批次的Spreadsheet对象后没有主动销毁相关资源，内存持续占用最终溢出。
• 不必要的对象重复实例化：行处理逻辑中每次都新建RohreRepository实例，无意义消耗内存和性能。
• 冗余操作：每次仅加载单个工作表处理，处理完批次后的工作表删除逻辑完全无效，属于无用代码。
• 配置与触发方式缺陷：如果是web请求触发该任务，即使设置了max_execution_time = 0，也会受到web服务器、PHP-FPM的超时限制，触发500错误。
• 日志IO开销过大：每个单元格都输出日志，高频IO操作拖慢执行效率，大幅提升超时概率。
• 分片大小不合理：20行的分片太小，会大幅增加Excel文件的加载次数，反而拉高整体性能开销。

优化方案 #

1. 每批次处理完成后主动释放内存，在chunk循环的末尾新增如下代码：

// 断开工作表连接，释放内存
$spreadsheet->disconnectWorksheets();
unset($spreadsheet, $objWorksheet);

2. 将$rohreRepository = new RohreRepository();移到所有循环外层，全局仅实例化一次。
3. 调整分片大小到200~500区间，平衡内存占用和IO开销。
4. 删除冗余代码：移除工作表删除相关逻辑、chunk循环中重复为$chunkSize赋值的无用代码。
5. 精简日志：仅保留必要的进度、错误日志，单元格级别的普通日志仅在调试模式下开启。
6. 大文件导入任务建议改为CLI脚本执行，完全规避web服务的超时限制。

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