应分块流式读取大excel：设setreaddataonly(true)，用getrowiterator()控制每块500行，及时unset；批量插入用事务包裹insertall()，单次≤1000条；字段映射需清洗标题、校验类型、转换日期；错误须带行号记录并返回前20条。
ThinkPHP 用 PhpSpreadsheet 分块读取大 Excel 文件
直接 load() 整个文件会爆内存，尤其上万行、多列、带样式的 Excel。必须按行分块流式读取，不把全量数据塞进 PHP 内存。
实操建议：
- 用
PhpSpreadsheet\Reader\Xlsx（或Xls）实例后，调用setReadDataOnly(true)关闭样式解析，提速 + 减内存 - 用
getWorksheetIterator()遍历工作表，再对每个表用getRowIterator($startRow, $chunkSize)控制每次只读$chunkSize行（比如 500） - 每块读完立即处理、入库、
unset()行对象和单元格引用，避免 PHP GC 滞后导致内存堆积 - 别用
getActiveSheet()->toArray()—— 它会强制加载整表到内存，跟不分块没区别
ThinkPHP 事务中批量插入 Excel 解析结果
单条 insert() 插一万行？慢且容易超时。但盲目用 insertAll() 又可能触发 MySQL 的 max_allowed_packet 或锁表时间过长。
实操建议：
- 每块解析出的数据（如 500 行），组装成二维数组后，用
Db::transaction()包裹Db::name('table')->insertAll($chunkData) - 控制单次
insertAll()不超过 1000 条（MySQL 默认max_allowed_packet=4M下较安全） - 事务内不做任何耗时操作（如发消息、调 API），否则事务持有锁时间拉长，阻塞其他写请求
- 捕获
Throwable后主动throw，确保事务回滚；别只echo错误就结束
Excel 字段映射与空值/类型校验绕不开的坑
用户上传的 Excel 经常列顺序错乱、标题含空格或换行、数字被 Excel 自动转成科学计数法（如 1.23E+10）、空单元格实际是 '' 或 null 或空白字符串。
实操建议：
- 先用第一行（
$worksheet->getCellByColumnAndRow($col, 1)->getValue()）提取标题，trim()+str_replace(["\n","\r"],"",$header)清理后再匹配字段名 - 数值列用
is_numeric()判定不够，要结合getDataType()：若为Cell::TYPE_NUMERIC且含小数点，用getFormattedValue()防科学计数丢失精度 - 日期列别依赖字符串匹配，用
PhpSpreadsheet\Shared\Date::excelToDateTimeObject($excelTimestamp)转 PHPDateTime - 空单元格统一转成
null（数据库允许 NULL）或默认值，别留着''导致int字段入库失败
导入进度与错误行定位必须落地到日志和前端反馈
用户传个 2w 行 Excel，卡住 30 秒没反应，或者只报“第 5001 行失败”，根本没法排查。
实操建议：
- 每处理完一块（如 500 行），记录当前已处理总行号到缓存（
cache('import_progress_'.$taskId, $currentRow)），前端可轮询获取进度 - 错误收集用独立数组：
$errors[] = ['row' => $excelRow, 'msg' => '手机号格式错误', 'data' => $rawRow]，别只抛异常 - 入库前做轻量级校验（必填、长度、正则），把错误拦在 DB 外；否则 MySQL 报错（如
Column 'xxx' cannot be null）无法对应原始行号 - 最终返回结构里必须包含
success_count、error_list（带行号），错误列表建议截取前 20 条，避免响应体过大
真正麻烦的不是读或插，是 Excel 格式千奇百怪 + 用户不看提示乱填 + 错误信息没绑定原始行号。这几处漏掉，上线后就是半夜告警电话。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
