phpspreadsheet大文件导入卡死的根本原因是iofactory::load()全量加载，执行解压、dom解析、样式重建、公式预计算四步操作；正确方案是load后立即setreaddataonly(true)，再用getrowiterator分块流式读取并手动unset释放内存。
PhpSpreadsheet大文件导入卡死，根本原因是IOFactory::load()全量加载
它不是“读取”，而是“解压+DOM解析+样式重建+公式预计算”四连发。一个10万行带格式的.xlsx，内存占用轻松突破512MB，直接触发Fatal error: Allowed memory size exhausted或max_execution_time超时。
别信“设了setReadDataOnly(true)就安全”——这个调用必须在IOFactory::load()之后、getWorksheetIterator()之前执行，顺序错一步，样式和字体照样全进内存。
- 必须在
$reader = IOFactory::load($file)后立刻调$reader->setReadDataOnly(true) - 不能依赖
getHighestRow()——它内部会强制触发全量解析来统计行数，一调就崩 - 禁止调用
toArray()，哪怕只对单个工作表调用，也会把整张表载入内存 - 合并单元格、条件格式、跨表引用等复杂结构，会让
setReadDataOnly(true)失效率飙升
getRowIterator()分块读才是唯一靠谱的流式方案
这是PhpSpreadsheet官方文档明确标注为“streaming read”的接口，但很多人用错位置或漏关键动作。
正确链路是：IOFactory::load() → setReadDataOnly(true) → $worksheet->getRowIterator(2, 500)（跳过标题，每块500行）→ 迭代处理 → 每轮结束立刻unset($row)和unset($cell)。
-
$startRow建议从2开始（跳过表头），避免每次都要if ($i === 1) continue判断 -
$chunkSize设500是实测平衡点：太小（如100）导致IO频繁；太大（如2000）单块内存仍可能飙到80MB+ - 每轮迭代完必须手动
unset($row)，PHP 8.3的GC对PhpOffice\PhpSpreadsheet\Worksheet\Row这类对象释放严重滞后 - 别在循环里反复调
$cell->getValue()三次——先存变量，再判断类型、格式化、空值转换
字段映射阶段最容易崩的四个坑
用户上传的Excel根本不按规范来：标题含不可见换行符、数字被Excel自动转成科学计数法、日期存的是44205这种时间戳、空单元格返回null/''/0三选一。
- 标题清洗必须做：
trim(str_replace(["\n","\r","\t"], '', $header))，否则$map['用户名']匹配不上$map["用户名\n"] - 数值列不能只靠
is_numeric()，要结合$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\Cell::TYPE_NUMERIC再取$cell->getFormattedValue()防1.23E+10失真 - 日期必须走
\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($value)，硬转(int)$value会得到1900-01-01 - 空值统一转
null，尤其对应数据库NOT NULL字段时，留着''插入直接报错
真正该放弃PhpSpreadsheet的时刻
当你的Excel含公式结果、合并单元格、条件格式，且行数稳定超过5万，或者你已踩过三次ChunkReadFilter的坑——它不是分块，是“伪分块”：ZIP照解、XML照析、只是赋值跳过，实测提速仅12%，但代码复杂度翻倍、错位率暴涨。
这时候该切方案：
- 前端用SheetJS把Excel转成CSV再提交，后端用
fopen()+fgetcsv()流式读，内存恒定几KB，百万行无压力 - 服务端换
xlswriter扩展（C实现），只读.xlsx，百万行导入压到40秒内，但需编译安装并启用extension=xlswriter.so - 纯PHP替代选
XlsxReader，不依赖扩展，但要手动处理sharedStrings.xml里的中文编码
最常被忽略的一点：事务批量入库的临界值不是越多越好。MySQL默认max_allowed_packet=4MB，1000行含中文数据就可能撑爆，建议按实际字段长度动态卡在500–800行之间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
