ThinkPHP怎么实现模型字段批量唯一索引校验_ThinkPHPExcel导入防重复技巧【技巧】-ThinkPHP-PHP中文网

thinkphp模型save()时需手动校验字段组合唯一性，因unique规则不支持多字段联合唯一，应通过where()+count()查重并排除自身；导入excel时应批量查重而非逐行查询，并注意null值导致联合索引失效问题。

thinkphp怎么实现模型字段批量唯一索引校验_thinkphpexcel导入防重复技巧【技巧】

直接用 unique 验证规则只能校验单字段，组合唯一（比如 user_id + sku_id）必须手动干预。ThinkPHP 的验证器不原生支持多字段联合唯一，硬套 ['unique' => 'table,field1,field2'] 会报错或失效。

实操建议：

在模型的 beforeWrite 或 save() 前，用 where() + count() 主动查重：
```
$exists = $this->where(['user_id' => $data['user_id'], 'sku_id' => $data['sku_id']])->count();
```
注意：要排除自身（更新场景），加 ->where('id', '', $this->id)
别依赖数据库唯一索引做唯一性兜底——它只抛 Integrity constraint violation 异常，前端无法区分是哪个字段冲突、也无法友好提示
如果并发写入高，仅应用层查重有竞态风险；真正防重必须配合数据库联合唯一索引（如 ALTER TABLE order_items ADD UNIQUE KEY uk_user_sku (user_id, sku_id);），但代码里仍要先查再写，否则异常难捕获

用 ThinkPHP + PHPExcel/PhpSpreadsheet 导入时，常见需求不是“报错中断”，而是“跳过重复项，只导入新数据”。关键在「查」和「跳」的时机与粒度。

实操建议：

不要每行都执行一次 where()->find() —— IO 太重，1000 行可能触发上千次查询。应先批量取出所有待导入的组合键（如 ['user_id,sku_id']），再用 where IN 一次性查出库中已存在的全部组合：
```
$keys = array_column($rows, 'user_id', 'sku_id');<br>$existKeys = Db::name('order_items')->where('concat(user_id,"_",sku_id)', 'in', $keys)->column('concat(user_id,"_",sku_id)');
```
用 array_diff_key() 或循环比对，筛出干净的新数据再批量插入，避免 insertAll() 中混入重复项导致部分失败
注意字符编码和空格：Excel 里导出的数字可能被当字符串读，123 和 "123" 在 MySQL 中可能不等价；建议统一 cast 类型或用 trim() 预处理

MySQL 的联合唯一索引生效前提是字段值不为 NULL —— 如果其中一列允许 NULL，那么 (1, NULL) 和 (1, NULL) 被视为不同记录，索引不拦截。

常见错误现象：

解决办法：

建联合唯一索引前，确认所有参与字段均为 NOT NULL，例如：

ALTER TABLE order_items MODIFY user_id INT NOT NULL DEFAULT 0;<br>ALTER TABLE order_items MODIFY sku_id VARCHAR(32) NOT NULL DEFAULT '';

导入前强制清洗数据：空字符串、空白符、"null" 字符串全转成默认值或抛出提示，别让 NULL 流到数据库
用 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE 替代普通 INSERT，但要注意这会让失败静默，不适合需要明确反馈的业务场景

用户上传 Excel 后，不能只回一句“导入失败”，得指出第几行哪一列出了什么问题。难点在于：验证逻辑分散（格式、长度、唯一性）、错误需按行聚合、还要保留原始行号（Excel 行号 ≠ 数组 key）。

实操建议：

遍历每一行时，用真实 Excel 行号（比如 $rowIndex + 1）作为错误数组的 key：

$errors[$rowIndex + 1] = [];<br>if (empty($cellValue)) {<br>    $errors[$rowIndex + 1][] = 'SKU 不能为空';<br>}

唯一性校验这类跨行检查，放在所有行解析完之后再集中做，否则无法知道“当前行是否和前面某行重复”；但错误信息里仍要标注双方行号（如“第5行与第12行 user_id+sku_id 重复”）
别把整个 $errors 直接 json_encode 返回——前端渲染大表格很慢。建议限制最多返回前 20 条错误，并加 total_error_count 字段供前端提示“共发现 142 条错误，仅显示前 20 条”

数据库联合唯一索引和应用层校验必须配对使用，少一个都会漏；而行号对齐、NULL 处理、批量查重这些细节，恰恰是上线后最容易被日志淹没的故障点。