ThinkPHP 5.1 不支持 INSERT ... ON DUPLICATE KEY UPDATE 原子操作，insertAll 默认冲突报错；可用 replace 模式（全量覆盖，但丢失自增ID）、原生 SQL 手动拼接 ON DUPLICATE KEY UPDATE（推荐，精准控制），或分批查询+事务处理。
ThinkPHP 5.1 本身不支持“插入新数据、跳过或更新已存在记录”这种原子操作（类似 MySQL 的 INSERT ... ON DUPLICATE KEY UPDATE），insertAll 默认遇到主键/唯一索引冲突会直接报错中断，而不是自动更新。要实现「批量添加并更新重复记录」，需结合具体需求选择合适方案。
用 insertAll + replace 模式（适合全量覆盖）
如果表结构有主键或唯一索引，且你希望「存在则替换、不存在则插入」，可用 insertAll($data, true) 启用 REPLACE 模式：
- 底层执行的是
REPLACE INTO，本质是先 DELETE 再 INSERT - 会丢失自增 ID（原记录被删，新 ID 可能变化）、可能触发外键级联删除，慎用于有强关联的表
- 时间戳字段（如
create_time）会被重写，不会保留原始创建时间
示例：
Db::name('user')->insertAll([
['id' => 1, 'name' => '张三', 'email' => 'z3@example.com'],
['id' => 2, 'name' => '李四', 'email' => 'l4@example.com']
], true); // 第三个参数 true 表示启用 REPLACE
手动拼接 ON DUPLICATE KEY UPDATE（推荐，精准控制）
这是最灵活、最贴近业务需求的方式，适用于需要「只更新部分字段、保留原值、做数值累加」等场景：
立即学习“PHP免费学习笔记（深入）”；
- 必须确保目标字段（如
id或email）上有 PRIMARY KEY 或 UNIQUE 索引 - 用
Db::execute()执行原生 SQL，字段和值需手动转义或使用参数绑定防注入 - 支持
VALUES(col)引用本次插入值，例如score = VALUES(score)或view_count = view_count + 1
示例（更新 name 和 email，冲突时仅改 name）：
$sql = "INSERT INTO user (id, name, email) VALUES (?, ?, ?), (?, ?, ?)
ON DUPLICATE KEY UPDATE name = VALUES(name)";
Db::execute($sql, [1, '王五', 'w5@ex.com', 2, '赵六', 'z6@ex.com']);
分批 + 事务 + 先查后判（适合小批量、逻辑复杂场景）
当需要根据是否存在执行不同逻辑（比如存在则累加积分、不存在则初始化），且数据量不大（≤200 条）时可选：
- 先用
where('id', 'in', [...])->column('id')查询已存在 ID 列表 - 分离出新增数组和更新数组
- 在事务中依次调用
insertAll()和updateAll()，并显式捕获异常回滚
注意：updateAll() 不支持 score = score + 1 这类表达式，如需计算，仍得用原生 SQL。
避坑提醒
以下行为容易导致预期外结果：
-
insertAll()不跳过冲突，默认整批失败；不要依赖返回值 > 0 就认为成功 -
updateAll()的 where 条件若传空数组或 null，条件会被静默忽略，看似没报错实则没生效 - 模型静态方法
User::where(...)->update(...)不触发自动时间戳、验证和事件钩子，需手动补update_time - 大批量操作（如超 500 条）建议分片，单次 ≤ 300 条，避免 PDO 参数超限或 MySQL max_allowed_packet 溢出
