iofactory::load($path) 常因临时文件被清理、路径权限不足、php 8+ 流处理严格或 reader 类型不匹配而失败；应优先用 $file->getrealpath() 获取真实路径，大文件须流式加载+逐行迭代，日期数字需手动类型识别与转换，并显式捕获 phpspreadsheet 异常。
直接用 IOFactory::load() 读上传文件路径，90% 的人会在 PHP 8+ 环境下报错或卡死——不是代码写错了，是路径、权限、内存和版本兼容性在联合发难。
为什么 IOFactory::load($path) 经常失败
上传后的临时文件路径（比如 /tmp/phpabc123）可能被 ThinkPHP 在后续流程中自动清理，IOFactory::load() 调用时文件已不存在；另外 Windows 路径含中文、Linux 下 tmp 目录无读权限、PHP 8+ 对 fopen 流处理更严格，都会触发 Could not open ... for reading! File does not exist。
- 永远别用
$file->getPathname()，它返回的是上传前的原始路径（如C:\Users\...\.xlsx），服务端根本打不开 - 必须立刻调用
$file->getRealPath()获取真实临时路径，且只在 upload 后第一行就取 - 如果仍失败，改用流式加载：用
fopen($file->getRealPath(), 'r')包一层再传给load() -
.xls和.xlsx必须匹配 reader 类型：createReader('Xls')或createReader('Xlsx')，传错抛Invalid reader
大文件导入时内存爆掉怎么办
getActiveSheet()->toArray() 会把整张表（含隐藏空行、合并单元格残留、格式元数据）全载入内存，一个 5MB 的 Excel 可能吃掉 800MB 内存，直接触发 PHP Fatal error: Allowed memory size exhausted 或被系统 kill。
- 禁用
toArray()，改用getRowIterator()+getCellIterator()手动逐行遍历 - 务必设置
$cellIterator->setIterateOnlyExistingCells(true)，跳过空白单元格 - 用
$row->getRowIndex() === 1判断表头，别依赖数组索引（合并单元格会让$index === 0不可靠） - 全空行检测要过滤掉空格和制表符：
empty(array_filter($values, 'trim'))
日期、数字类型读出来是乱码或科学计数怎么办
PhpSpreadsheet 默认把 Excel 单元格值原样返回，但 Excel 里“2025-03-15”实际存的是序列号（如 45721），数值可能被转成 1.23456789E+10，不转换就入库会导致数据错乱。
- 用
$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\DataType::TYPE_NUMERIC判断是否为数字型 - 日期需结合单元格样式判断：
$cell->getStyle()->getNumberFormat()->getFormatCode()匹配'yyyy-mm-dd'类格式后，再用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject()转换 - 纯数字（如电话、ID）若被识别为浮点，用
(string) round($value)强转并去掉小数点，避免末尾补零 - 不要依赖
getValue()的自动类型推断，它在不同 locale 下行为不一致
异常捕获漏掉关键错误导致静默失败
PhpSpreadsheet 抛的异常不走 ThinkPHP 的 think\facade\Log，也绕过全局异常处理器。没显式 catch，上传成功但数据一行没进库，前端还显示“导入完成”，问题极难定位。
- 必须单独捕获两个核心异常：
PhpOffice\PhpSpreadsheet\Exception（解析层）和InvalidArgumentException（参数/格式错误） - TP6+ 中日志记录要手动写：
\think\facade\Log::error('Spreadsheet error: '.$e->getMessage()) - 对
getCellIterator()迭代过程中的OutOfBoundsException也要兜底，防止某列缺失导致整批中断 - 别在循环里用
Db::insertAll()一次插全部——出错无法定位哪行失败；改用事务 + 单条insert()并记录失败行号
真正麻烦的从来不是“怎么读出来”，而是“怎么稳定地、可回溯地、不崩内存地读出来”。每一步都要假设 Excel 是恶意构造的：空行嵌套、合并单元格跨百列、日期格式混用、数字列夹着文本字符串——按这个思路写，才不会上线三天就被运营扔来一个崩溃文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
