ThinkPHP导入Excel时需避免重复插入：先批量提取组合键构造二维数组，再一次性查询数据库比对，用array_diff_key筛选新数据，且表必须建联合唯一索引；Excel端可用COUNTIFS公式本地校验；返回具体错误行号；NULL值须转为默认值防索引失效。
ThinkPHP导入Excel时，数据库已存在相同组合字段的数据却仍被重复插入，导致业务逻辑错乱、统计失真、前端提示模糊——这不是验证器没配好，而是批量校验路径选错了。
先查库再写入：批量提取组合键比对
不要在 saveAll() 里依赖 unique 规则，它根本不会触发数据库查询；也不要逐行执行 where()->count()，1000 条数据就是 1000 次 SQL 查询，IO 直接拖垮服务。
第一步：从 Excel 解析出的所有行中，提取需校验的字段组合，构造成二维数组键值对。例如联合唯一字段是 user_id 和 sku_id，则每条数据生成 [$row['user_id'], $row['sku_id']]。
第二步：用 where(['user_id' => ['in', $userIds]]) → select() 一次性查出库里所有匹配的记录，注意必须用 array_column 提取原始组合键，不能只取单列。
立即学习“PHP免费学习笔记（深入）”；
第三步：将库中已存在的组合键转为字符串键（如 "1001_2005"），Excel 待插入组合也做同样转换，用 array_diff_key() 筛出干净的新数据。
【关键前提】数据库表必须已建联合唯一索引，例如 ALTER TABLE order_item ADD UNIQUE KEY uk_user_sku (user_id, sku_id); 否则即使代码查重成功，高并发下仍可能插入成功。
Excel本地去重：上传前用公式标记重复行
适用于运营人员手动整理后上传的场景，能提前暴露问题，减少后端压力。
在 Excel 表格中，选中要校验的列（比如 A2:A5000），点击「数据」→「数据验证」→「允许」选「自定义」→ 公式栏填入 =COUNTIF($A:$A00,A2)=1。
罗老师数据不上传 Excel VBA 本地处理专家 是一个面向企业隐私数据、本地化数据处理和 Excel 自动化的新手陪跑 skill。它不会要求用户上传原始表格，而是引导用户只提供表名、字段、规则和脱敏样例，再生成可复制到 Excel 里运行的 VBA 代码，帮助完成清洗、匹配、筛选、汇总、拆分和报表生成等任务。
切换到「出错警告」页，标题写“录入失败”，错误信息写“该编号已在列表中存在，请勿重复提交”。点确定后，用户粘贴或输入重复值会直接弹窗拦截。
这一步操作起来很简单，直接把文件拖进去就行，但仅对单字段有效；若需 user_id+product_id 联合校验，就得用 COUNTIFS 函数，公式写成 =COUNTIFS($B$2:$B$5000,$B2,$C$2:$C$5000,$C2)=1，其中 B 列是 user_id，C 列是 product_id。
返回具体错误位置：让前端知道哪一行哪一列重复了
用户需要的不是“存在重复数据”这种笼统提示，而是“第37行，订单号与商品ID组合已在数据库中存在”。
方法一：遍历原始 Excel 行数据时，用 foreach($rows as $index => $row) 带上原始索引；比对出重复项后，把 $index 和 $row['user_id'].'_'.$row['sku_id'] 一起存进 $duplicateMap 数组。
方法二：查库返回的 $exists 记录必须包含主键 id 和校验字段，不能只查字段值；否则无法区分是新增冲突还是更新自身冲突。
最后统一组装错误响应：return json(['code'=>400,'msg'=>'发现3处重复','data'=>$duplicateMap]); 前端可据此高亮表格对应行。
NULL值陷阱：联合唯一索引失效的静默漏洞
MySQL 的联合唯一索引对 NULL 值不生效——(123, NULL) 和 (123, NULL) 被视为两条不同记录，索引完全不拦截。
Excel 导入时，空单元格常被读成 null 或空字符串，入库前必须强制转换：$row['sku_id'] = $row['sku_id'] ?: 0; 或 $row['sku_id'] = trim((string)$row['sku_id']) ?: '0';
【致命坑】建表时未设 NOT NULL，又没给默认值，该字段业务上理应必填，但数据库允许 NULL，此时联合唯一形同虚设。
