Laravel如何做数据导入校验_Laravel Excel导入验证方法【方法】

做数据导入校验，最怕什么？当然是数据都写进去了才发现问题，然后回滚、清理脏数据，折腾半天。其实根本不用走到那一步——在解析 Excel 行的时候就该把校验拦住。下面这几条经验，是处理 Lara vel Excel 导入时最容易踩的坑，一次性说清楚。 ## 导入前校验失败直接中断，别等 `import()` 跑完才发现问题 Lara vel 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`。 - Excel 文件强制设 `delimiter` 会导致 `Maatwebsite\Excel\Validators\Failure` 报 `"Invalid cell coordinate"`。 - 如果上传文件类型不可控（用户可能传 .xls/.xlsx/.csv），建议先用 `mime_content_type()` 或扩展名判断，再分发到不同 Import 类，而不是塞进一个类硬扛。 - `WithHeadingRow` 在 Excel 中读取第一行当字段名，但若第一行有合并单元格，会返回 `null` 键名，导致后续 `$row['email']` 报错；务必加空值保护：`$row[0] ?? ''`。 ## 自定义错误提示不显示在 `failures()` 里？因为没实现 `WithValidation` 的完整契约 写了 `rules()` 和 `customValidationMessages()`，但导出失败记录时只有默认英文提示，甚至空着——大概率是没同时实现 `onFailure()` 方法。Lara vel 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()` 就完事，关键在时机、上下文和边界控制——尤其是混合文件类型、大文件、跨行约束这三类场景，随便套模板都会出问题。