Laravel Excel 导入校验需前置执行：用 ToArrayImport 读取全量数据，手动归一化类型（trim、filter_var）后统一验证，避免先入库再回滚；禁用 WithChunkReading 与验证混用，分阶段处理大数据；区分 Excel/CSV 配置，注意合并单元格、MIME 类型判断及 onFailure 实现。
导入前校验失败直接中断，别等 import() 跑完才发现问题
Laravel Excel 默认是「先导入后验证」，数据塞进数据库再跑 rules()，出错就得回滚、清理脏数据。真要校验，得在解析 Excel 行时就拦截——靠 WithValidation + SkipsOnFailure 组合，但注意：它只跳过单行，不阻止整个导入继续。真正可靠的做法是提前用 ToArrayImport 读取全部数据，手动调用 Validator::make() 校验整个二维数组。
-
ToArrayImport返回的是原始值（字符串/数字），日期、空格、布尔等不会自动转换，校验前得先做类型归一化 - Excel 单元格里常见的
"1 "（带空格）、"true"（小写字符串）会过不了"required|boolean"这类规则，建议统一trim()和filter_var($v, FILTER_VALIDATE_BOOLEAN) - 别在校验逻辑里查数据库（比如
"unique:users,email"），ToArrayImport是内存操作，没 DB 连接上下文；需查重的字段，先pluck('email')拉出来批量whereIn查一次
WithCustomCsvSettings 对 Excel 和 CSV 处理不一致，别混用
很多人加了 WithCustomCsvSettings 想统一处理 CSV 和 XLSX，但 CSV 的 enclosure、delimiter 对 Excel 文件完全无效，反而可能让 PhpSpreadsheet 解析异常（比如把合并单元格拆成多行）。Excel 导入该用 WithHeadingRow 或 WithStartRow 控制起始位置，CSV 才用 WithCustomCsvSettings。
诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿
- Excel 文件强制设
delimiter会导致Maatwebsite\Excel\Validators\Failure报"Invalid cell coordinate" - 如果上传文件类型不可控（用户可能传 .xls/.xlsx/.csv），建议先用
mime_content_type()或扩展名判断，再分发到不同 Import 类，而不是塞进一个类硬扛 -
WithHeadingRow在 Excel 中读取第一行当字段名，但若 Excel 第一行有合并单元格，会返回null键名，导致后续$row['email']报错；务必加空值保护：$row[0] ?? ''
自定义错误提示不显示在 failures() 里？因为没实现 WithValidation 的完整契约
写了 rules() 和 customValidationMessages()，但导出失败记录时只有默认英文提示，甚至空着——大概率是没同时实现 onFailure() 方法。Laravel Excel 的验证失败收集依赖 onFailure() 显式接收 Failure 实例，否则消息不会进 $import->failures() 数组。
- 必须返回
void，不能return $failure或抛异常，否则中断整个导入流程 -
Failure对象的errors()是原始验证器返回的MessageBag，但它的 key 是列索引（如0、2），不是字段名；想按字段名映射，得在headingRow()后手动构建列名 → 索引映射表 - 中文提示要生效，
customValidationMessages()里的 key 得严格匹配规则键名，比如'email.required' => '邮箱不能为空'，漏掉.required就 fallback 到默认提示
大数据量下内存爆掉？WithChunkReading 和校验根本互斥
WithChunkReading 是为流式读取设计的，每 chunk 处理一批行，但它和 WithValidation 冲突：验证需要整行上下文（比如“用户名不能重复”需查全量），而 chunk 是割裂的。强行混用，要么漏报重复，要么 chunk 加载时就把整表读进内存，失去 chunk 意义。
- 真要处理万级数据，分两阶段：第一阶段用
ToArrayImport做轻量校验（格式、必填、长度），通过后再用WithChunkReading+DB::transaction()批量插入，重复校验改用数据库唯一索引 +ignoreDuplicates() -
ini_set('memory_limit', '512M')是临时止痛药，治标不治本；Excel 文件本身含样式、公式、隐藏列时，PhpSpreadsheet内存占用会翻倍，上传前用 Excel 软件另存为「无样式纯数据」版本更有效 - 校验耗时主要在正则和数据库查询，把
email、phone这类规则换成filter_var()，比regex:/^...$/快 3–5 倍
rules() 就完事，关键在时机、上下文和边界控制——尤其是混合文件类型、大文件、跨行约束这三类场景，随便套模板准出问题。 
