ThinkPHP批量添加跳过重复记录需依赖数据库唯一索引，TP6.1+推荐用insertAll($data, true, true)启用INSERT IGNORE；低版本可用onDuplicateKeyUpdate实现更新或replace慎用；无索引时可应用层预查去重。
ThinkPHP 批量添加数据时跳过重复记录，核心是利用数据库的 INSERT IGNORE（MySQL）或 ON DUPLICATE KEY UPDATE 机制，配合 ThinkPHP 的 insertAll() 方法和模型配置实现。关键前提是：表中必须有唯一索引（如 UNIQUE KEY 或主键），否则数据库无法识别“重复”。
确保字段有唯一索引
这是跳过重复的前提。比如你按 email 字段去重，就要在数据库中为该字段加唯一索引：
ALTER TABLE `user` ADD UNIQUE INDEX `idx_email` (`email`);
使用 insertAll() + ignore 参数（TP6.1+）
ThinkPHP 6.1 及以上版本支持 insertAll() 的 ignore 参数，底层会自动拼接 INSERT IGNORE：
立即学习“PHP免费学习笔记（深入）”；
- 适用于 MySQL，且表含唯一索引
- 重复数据会被静默忽略，不报错，返回实际插入条数
- 代码简洁，推荐首选
$data = [['name' => '张三', 'email' => 'a@x.com'], ['name' => '李四', 'email' => 'b@x.com']];<br>
$result = Db::name('user')->insertAll($data, true, true); // 第三个参数 true = ignore
手动用 replace 或 onDuplicateKeyUpdate（兼容旧版）
如果版本较低或需更精细控制，可改用：
-
replace()：先删后插（慎用，会触发 DELETE 行为，影响自增 ID 和外键） -
onDuplicateKeyUpdate()：遇到重复时更新指定字段（非跳过，但很实用）
$db = Db::name('user');<br>
$db->onDuplicateKeyUpdate(['name' => Db::raw('VALUES(name)')])<br>
->insertAll($data);→ 重复时只更新 name，其他字段不变。
应用层预判去重（备用方案）
当无法修改表结构、或需复杂去重逻辑时，可先查出已存在值再过滤：
- 提取待插入数据中的关键字段（如所有 email）
- 用
whereIn查询库中已存在的值 - 用
array_diff或循环剔除，再插入剩余数据
缺点是多一次查询，高并发下仍有极小概率冲突，仅作兜底。
