必须在写入前校验重复,避免依赖数据库唯一索引报错导致提示不明确;用array_map提取结构化键数组防拼接歧义,whereIn一次性查库并严格匹配联合字段,再通过array_intersect比对去重,最后分批或单条插入以精准定位错误。

ThinkPHP导入Excel时检测重复记录,必须在数据写入数据库前完成校验,否则依赖数据库唯一索引报错会导致前端无法定位哪一行、哪个字段冲突,也无法友好提示用户;逐行查库会引发上千次IO,1000条数据可能拖垮服务器。
先提取待入库的关键组合字段
打开Excel解析后的二维数组 $rows,用 array_map 提取每条记录中参与唯一性判断的字段,拼成可比对的键数组。例如要确保 user_id 和 sku_id 联合唯一,就构造形如 [1001, 'SKU-002'] 的子数组:
复制代码:
$keys = array_map(function($item) { return [$item['user_id'], $item['sku_id']]; }, $rows);
这一步不能直接用 implode('_', $item) 拼接字符串——若 user_id 是 1、sku_id 是 '002',拼成 '1_002';而另一条是 user_id=10、sku_id='02',也会拼成 '10_02',但和 '1_002' 看似不同,实际业务中可能语义等价,极易漏判。必须保持结构一致,用数组承载原始类型。
立即学习“PHP免费学习笔记(深入)”;
批量查出数据库中已存在的组合
用 whereIn 查询一次性拉取所有可能冲突的记录,避免 N+1 查询:
先提取所有待查的 user_id 集合:
$userIds = array_unique(array_column($rows, 'user_id'));
再查库获取已有组合:
$exists = Db::name('order_items')
->where('user_id', 'in', $userIds)
->select()
->toArray();
【注意:不能写成 whereIn('user_id', ...)->whereIn('sku_id', ...)】 这会变成 OR 逻辑,查出大量误报结果,比如库里有 (1001,'A') 和 (1002,'B'),你传入 [1001,1002] 和 ['A','B'],最终匹配到全部两条,而非精确的 (1001,'A') 和 (1002,'B')。
接着把查出的结果也转为相同结构的键数组:
$existKeys = array_map(function($e) { return [$e['user_id'], $e['sku_id']]; }, $exists);
比对并筛出干净的新数据
用 array_intersect 对比 $keys 和 $existKeys,得到重复项列表:
$duplicates = array_intersect($keys, $existKeys);
再用 array_diff_key 反向筛出可插入的新数据索引:
$validRows = [];
foreach ($rows as $index => $row) {
if (!in_array([$row['user_id'], $row['sku_id']], $duplicates)) {
$validRows[] = $row;
}
}
此时 $validRows 就是真正可安全 insertAll 的数据集合。如果需要返回错误详情(比如告诉用户第5行 user_id=1001 & sku_id='SKU-002' 已存在),就把 $duplicates 和原始 $rows 的 key 做绑定映射,遍历构建错误位置信息。
事务包裹插入并捕获具体失败点
方法一:用 try/catch 包裹 insertAll,但仅靠异常无法区分是哪条数据冲突:
Db::startTrans();
try {
Db::name('order_items')->insertAll($validRows);
Db::commit();
} catch (\Exception $e) {
Db::rollback();
// 此处只能知道整体失败,不知道哪条出问题
}
方法二:改用 foreach + save() 单条写入,配合模型 beforeWrite 中的 where()->count() 校验——虽慢但能精准定位错误行,适合数据量 ≤200 条的管理后台场景。
方法三:分批插入 + 批量查重回滚——将 $validRows 按 100 条切块,每块插入前再做一次小范围查重,失败则只回滚当前批次,其余继续。这需要手动维护事务嵌套层级,不推荐新手直接上手。



















