ThinkPHP导入Excel报错主因是临时路径失效、内存溢出、类未找到、日期乱码及RichText异常；需用getRealPath()及时获取真实路径、流式加载与遍历、正确引入phpspreadsheet、转换日期类型、处理RichText对象。
ThinkPHP导入Excel时提示报错，多数不是代码写错了，而是临时文件路径失效、内存爆掉、类型识别错误或PHP版本不兼容导致的——这些问题在上传后第一秒就埋下了隐患，稍不注意就会卡在IOFactory::load()或toArray()上直接报Fatal error。
路径失效：Could not open for reading! File does not exist
第一步：立刻用 【$file->getRealPath()】 替换 $_FILES['file']['tmp_name'] 或 $file->getPathname()；前者返回真实临时路径（如 /tmp/phpabc123），后者返回客户端原始路径（如 C:\Users\test.xlsx），服务端根本打不开。
第二步：检查ThinkPHP是否在 upload 完成后自动清理了临时文件——TP5/TP6 默认会在 Request 对象销毁时调用 unlink()。必须在接收到 $file 后**第一行代码**就执行 $realPath = $file->getRealPath()，延迟哪怕一行都可能被删。
第三步：若仍失败，改用流式加载：$handle = fopen($realPath, 'r'); $spreadsheet = IOFactory::load($handle); 这能绕过fopen权限校验，在Windows中文路径或Linux tmp无读权限时特别有效。
立即学习“PHP免费学习笔记（深入）”；
类找不到：Class not found 或 PHPExcel_IOFactory not found
方法一：确认已执行 composer require phpoffice/phpspreadsheet（别用已废弃的PHPExcel）；TP6+必须用phpspreadsheet，且命名空间必须写全——use PhpOffice\PhpSpreadsheet\IOFactory; 漏掉 PhpOffice\ 前缀必报错。
方法二：检查PHP版本。phpspreadsheet 1.20+ 要求 PHP ≥ 7.4；TP5.1 最低需 PHP 7.1，但低于 7.4 会导致 DateTime 处理异常，看似类找到了，实则运行时报错。
方法三：禁用 ThinkPHP 的自动加载冲突。在 composer.json 中确保 "autoload": {"psr-4": {"App\": "app/"}} 未覆盖 vendor 下的 PhpOffice 命名空间；执行 composer dump-autoload -o 强制刷新。
内存溢出：Allowed memory size exhausted
直接调用 $worksheet->toArray() 是最常见诱因——它会把整张表（含隐藏空行、合并单元格残留、格式元数据）全载入内存，一个5MB的Excel可能吃掉800MB内存。
必须改用流式遍历：
① 获取行迭代器：$rowIterator = $worksheet->getRowIterator();
② 设置跳过空白单元格：$rowIterator->setIterateOnlyExistingCells(true);
③ 遍历时用 $row->getRowIndex() === 1 判断表头，别依赖数组索引（合并单元格会让 $data[0] 不是表头）；
④ 全空行检测要过滤空格和制表符：empty(array_filter($values, 'trim'))。
大文件导入时，每处理1000行手动触发一次 gc_collect_cycles()，防止PHP垃圾回收滞后。
日期数字乱码：显示为45721或1.23456789E+10
Excel里“2025-03-15”实际存的是序列号45721，数值列可能被转成科学计数，不转换就入库会导致数据错乱。
先判断单元格类型：$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\DataType::TYPE_NUMERIC；再结合样式判断是否为日期：$cell->getStyle()->getNumberFormat()->getFormatCode() 匹配 'yyyy-mm-dd' 或 'm/d/yyyy' 等格式码。
匹配成功后，用 \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($cell->getValue(), $timezone) 转换，否则直接 getValue() 返回的就是原始数字。
RichText对象异常：显示PHPExcel_RichText Object
当单元格含富文本（如部分加粗、不同字体），getValue() 返回的是 PhpSpreadsheet\RichText 对象而非字符串，直接 echo 或 insert 会输出对象结构。
统一加一层类型判断和转换：
if (is_object($value) && method_exists($value, '__toString')) {
$value = $value->__toString();
}
