thinkphp导入excel报“格式不正确”主因是路径与环境适配问题：须用$file->getrealpath()获取真实临时路径，避免getpathname()返回客户端路径；推荐iofactory::identify()自动识别格式；禁用toarray()改用行迭代降低内存；日期需同时满足数值类型和日期格式才转换。
ThinkPHP导入Excel时提示“格式不正确”，常见于上传后直接传临时路径给IOFactory::load()、中文路径未转义、reader类型错配或PHP 8+流处理失败，90%的报错根源不在代码逻辑而在路径与环境适配。
第一步：确认并修正Excel文件路径来源
永远别用$file->getPathname()——它返回的是客户端原始路径（如C:\Users\张三\test.xlsx），服务端根本打不开。【必须立刻调用$file->getRealPath()获取真实临时路径，且只在 upload 后第一行就取】
若仍报Could not open ... for reading! File does not exist，说明ThinkPHP已在后续流程中自动清理了临时文件。此时需改用流式加载：
用fopen($file->getRealPath(), 'r')包一层，再传给IOFactory::load()，避免路径失效导致的静默失败。
第二步：匹配正确的Reader类型
方法一：根据文件扩展名显式指定reader
IOFactory::createReader('Xlsx')用于.xlsx文件，IOFactory::createReader('Xls')用于.xls文件；传错会抛出Invalid reader异常。
方法二：自动探测类型（推荐）
使用IOFactory::identify($file->getRealPath())先获取真实格式，再动态调用对应reader，避免硬编码导致的格式误判。
第三步：绕过toArray()内存陷阱
1、禁用getActiveSheet()->toArray()——5MB Excel可能吃掉800MB内存，直接触发Fatal error: Allowed memory size exhausted。
2、改用流式遍历：$spreadsheet->getActiveSheet()->getRowIterator()逐行读取。
3、每行内启用$cellIterator->setIterateOnlyExistingCells(true)跳过空白单元格，大幅降低内存占用。
4、表头识别不用$index === 0——合并单元格会让索引错位，应改用$row->getRowIndex() === 1精准定位首行。
第四步：修复日期和数字乱码
Excel里显示“2026-07-09”，读出来却是45865，是因为PhpSpreadsheet默认返回原始序列号而非格式化日期。【必须同时满足数值类型+日期格式代码才可执行转换】
先判断：$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\DataType::TYPE_NUMERIC，再检查$cell->getStyle()->getNumberFormat()->getFormatCode()是否匹配'yyyy-mm-dd'等日期格式。
转换用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($excelDate)返回DateTime对象，再format('Y-m-d')输出标准字符串。
遇到PHPExcel_RichText Object异常？说明单元格含富文本格式，直接$cell->__toString()转成字符串即可安全读取。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
