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 默认开启自动实例化和容器绑定，但 PhpSpreadsheet\IOFactory::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 = \PhpOffice\PhpSpreadsheet\IOFactory::load($path) - TP8.0 的
think\facade\Db查询结果若转成大数组再喂给 PhpSpreadsheet，会二次放大内存压力 - 未关闭自动计算（
$spreadsheet->setCalculationEngineEnabled(false)）时，公式字段会持续占用计算上下文
setReadDataOnly(true) 和 setLoadSheetsOnly() 必须配对用
只设 setReadDataOnly(true) 不够——它跳过样式/字体/公式，但依然会加载所有工作表；而 setLoadSheetsOnly(['Sheet1']) 若没配合前者，仍会把每个 Sheet 的格式元数据全读进来。
立即学习“PHP免费学习笔记（深入）”；
正确顺序和组合：
$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader('Xlsx');
$reader->setReadDataOnly(true);
$reader->setLoadSheetsOnly(['数据表']); // 名称必须严格匹配 Excel 里的 tab 名
$spreadsheet = $reader->load($filePath);
- 如果 Excel 有多个 Sheet 但只需读取一个，漏掉
setLoadSheetsOnly()会让内存多涨 40%~60% - Sheet 名含空格或中文时，
setLoadSheetsOnly()参数必须原样复制，区分大小写 -
setReadDataOnly(true)后日期列会变成数字（如44562），需手动调用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject()
流式读取才是 TP8.0 场景下的安全底线
TP8.0 常用于 Web 导入接口，用户上传文件后需校验+入库。这时绝不能等 load() 完再处理——应边读边校验、边写 DB 边释放。
关键点在于：不用 getActiveSheet()->toArray()，改用 getRowIterator() + 手动释放行引用：
$reader = \PhpOffice\PhpSpreadsheet\IOFactory::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 Symfony\Component\Cache\Adapter\FilesystemAdapter;
use Symfony\Component\Cache\Psr16Cache;
$adapter = new FilesystemAdapter('ps', 3600, runtime_path('cache/excel'));
$cache = new Psr16Cache($adapter);
\PhpOffice\PhpSpreadsheet\Settings::setCache($cache);
注意：runtime_path('cache/excel') 必须是 TP8.0 可写的本地路径，且不能与框架默认缓存目录混用——否则并发写入易冲突。
最易被忽略的一点：TP8.0 的中间件或异常处理器若捕获了 PhpSpreadsheet 抛出的 Exception，但没显式 unset($spreadsheet)，该对象会一直挂在请求生命周期里，直到脚本结束才释放——这对高频导入接口就是隐性内存泄漏。
