如何用 TP8.0 处理 Excel？PhpSpreadsheet 读写与内存泄漏解决【办公】

TP8.0 直接用 IOFactory::load() 会崩，是因为它把整张 Excel（包括样式、公式、合并单元格）一股脑全塞进内存。5万行×20列的文件，在 PHP 8.x 下轻轻松松突破 300MB——远超默认的 128M~256M 限制，结果就是 Fatal error 或者 php-fpm worker 直接被 kill。

TP8.0 本身不内置 Excel 处理能力，必须依赖 PhpSpreadsheet；内存泄漏不是 PhpSpreadsheet 的 bug，而是误用缓存、未释放对象或全量加载导致的资源滞留。

为什么 TP8.0 直接用 load() 会崩？

ThinkPHP 8.0 默认开启了自动实例化和容器绑定，但 PhpSpreadsheetIOFactory::load() 会把整张表——包括样式、公式、合并单元格——全部载入内存。一个 5 万行 × 20 列的 Excel，在 PHP 8.x 下轻松吃掉 300MB+ 内存，而 TP8.0 常见的默认限制只有 128M~256M，不崩才怪。

常见错误现象包括：Fatal error: Allowed memory size of 268435456 bytes exhausted，或者脚本卡死、php-fpm worker 被 kill。

• 别在控制器里直接写 $spreadsheet = PhpOfficePhpSpreadsheetIOFactory::load($path)
• TP8.0 的 thinkfacadeDb 查询结果如果转成大数组再送给 PhpSpreadsheet，内存压力会二次放大
• 没关闭自动计算（$spreadsheet->setCalculationEngineEnabled(false)）时，公式字段会持续占用计算上下文

setReadDataOnly(true) 和 setLoadSheetsOnly() 必须配对用

光设 setReadDataOnly(true) 远远不够——它跳过样式、字体、公式，但依然会加载所有工作表；而 setLoadSheetsOnly(['Sheet1']) 如果不配合前者，每个 Sheet 的格式元数据照样全读进来。

正确的顺序和组合如下：

$reader = PhpOfficePhpSpreadsheetIOFactory::createReader('Xlsx');
$reader->setReadDataOnly(true);
$reader->setLoadSheetsOnly(['数据表']); // 名称必须严格匹配 Excel 里的 tab 名
$spreadsheet = $reader->load($filePath);

• 如果 Excel 有多个 Sheet 但只需读取一个，漏掉 setLoadSheetsOnly() 会让内存多涨 40%~60%
• Sheet 名含空格或中文时，setLoadSheetsOnly() 参数必须原样复制，区分大小写
• setReadDataOnly(true) 后日期列会变成数字（如 44562），需手动调用 PhpOfficePhpSpreadsheetSharedDate::excelToDateTimeObject()

流式读取才是 TP8.0 场景下的安全底线

TP8.0 常用于 Web 导入接口，用户上传文件后需要校验、入库。这时候绝对不能等 load() 完再处理——应该边读边校验、边写 DB 边释放。

关键点在于：不用 getActiveSheet()->toArray()，改用 getRowIterator() + 手动释放行引用：

$reader = PhpOfficePhpSpreadsheetIOFactory::createReader('Xlsx');
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($filePath);
$worksheet = $spreadsheet->getActiveSheet();
foreach ($worksheet->getRowIterator() as $row) {
    $cellIterator = $row->getCellIterator();
    $cellIterator->setIterateOnlyExistingCells(false); // 空列也要读到
    $rowData = [];
    foreach ($cellIterator as $cell) {
        $rowData[] = $cell->getValue();
    }
    // ✅ 此处插入 DB 或校验逻辑
    Db::name('contact')->insert($rowData);
    // ⚠️ 强制释放当前行对象，防止引用滞留
    unset($row, $cellIterator, $rowData);
}
// ✅ 最后彻底销毁 spreadsheet 实例
unset($spreadsheet, $worksheet, $reader);

• TP8.0 的 Db::insert() 若批量执行，建议每 500 行 commit 一次，避免事务锁太久
• 循环内不调用 $spreadsheet->disconnectWorksheets()——它在 TP8.0 容器环境下可能引发不可预知的引用残留
• 务必在循环外加 gc_collect_cycles()（尤其 PHP 8.1+），否则某些版本 GC 不会及时回收 Cell 对象

缓存不是万能解药，选错方案反而更慢

TP8.0 项目常部署在 Docker 或共享主机上，APCu/Redis 并非总可用。盲目启用缓存可能引入新瓶颈：

• 用 FilesystemAdapter（磁盘缓存）时，TP8.0 的 storage_path('framework/cache/data') 若挂载在 NFS 或低 IOPS 卷上，读写延迟会拖慢整体导入速度
• APCu 在多 worker 进程下不共享缓存，每个 php-fpm 进程都建一份，内存节省效果打折扣
• Redis 缓存需额外维护连接池，TP8.0 默认不集成连接管理，容易因超时或断连抛出 CacheException

真正有效的缓存配置（仅限单机、高内存场景）：

use SymfonyComponentCacheAdapterFilesystemAdapter;
use SymfonyComponentCachePsr16Cache;
$adapter = new FilesystemAdapter('ps', 3600, runtime_path('cache/excel'));
$cache = new Psr16Cache($adapter);
PhpOfficePhpSpreadsheetSettings::setCache($cache);

注意：runtime_path('cache/excel') 必须是 TP8.0 可写的本地路径，且不能与框架默认缓存目录混用——否则并发写入易冲突。

最易被忽略的一点：TP8.0 的中间件或异常处理器若捕获了 PhpSpreadsheet 抛出的 Exception，但没显式 unset($spreadsheet)，该对象会一直挂在请求生命周期里，直到脚本结束才释放——这对高频导入接口就是隐性内存泄漏。