必须先建唯一索引，再用insert ignore手写sql静默插入；若需定位重复行，则导入前用wherein查重并绑定原始索引反馈；慎用replaceinto和逐条事务。
ThinkPHP 8.0 批量插入时遇到重复数据，不能依赖 insertAll 自动跳过，它一冲突就报错中断；必须结合数据库约束与主动控制策略，从“防插”和“预检”两个方向解决。
必须先建唯一索引
这是所有去重方案生效的前提：在数据库表中为待校验字段（如 email、order_id + sku_id）添加 UNIQUE 或 PRIMARY KEY 约束。没有这个，INSERT IGNORE 不起作用，replaceInto 会误删，校验查询也失去依据。
推荐用 INSERT IGNORE 手写 SQL
绕过框架限制，直接执行带 IGNORE 的原生语句，高效且静默：
- 拼接字段名与占位符，确保顺序和数量严格匹配数据结构
- 把二维数组
$data转成扁平的VALUES (?, ?, ?), (?, ?, ?)格式 - 参数必须是一维数组，例如：
[1,'a@x', 'A', 2,'b@x','B'] - 调用：
Db::execute("INSERT IGNORE INTO user (id, email, name) VALUES (?, ?, ?), (?, ?, ?)", $params);
导入前手动查重并反馈具体位置
如果需要告诉用户“第3行邮箱重复”，就不能靠数据库静默忽略，得提前比对：
- 提取所有待插入的校验字段值，组成键数组，如
array_map(fn($x) => [$x['email']], $data) - 用
whereIn查库已存在记录（注意：联合唯一需整体查，别拆成多个whereIn） - 用
array_intersect找出重复项，并绑定原始索引号 - 返回类似
['row' => 3, 'field' => 'email', 'value' => 'test@x']的结构，便于前端提示
慎用 replaceInto 和事务逐条
replaceInto 实质是“删+插”，会清空主键 ID、触发外键级联删除，有数据风险；事务 + try/catch 逐条 save() 虽能精确定位错误，但 500 条数据就是 500 次查询，性能差，只适合小批量且强反馈场景。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
