ThinkPHP的saveAll不自动区分增删改，而是逐条调用save()：主键存在且匹配记录则更新，主键存在但不匹配则UPDATE影响0行，不含主键或字段名不匹配则全部新增；推荐用replace()或手动分组处理。
ThinkPHP 的 saveAll 方法本身不自动区分新增还是更新逻辑，它只是批量调用每条数据的 save()，而每条数据走新增还是更新，取决于该条数据是否包含有效主键值，以及模型当前的 isUpdate 状态。
关键不是 saveAll 做判断，而是每一条传入的数据在内部调用 save() 时如何被识别。
✅ 主键存在且能匹配记录 → 触发更新
saveAll 接收一个二维数组，例如：
$data = [
['id' => 1, 'name' => '张三', 'status' => 1],
['id' => 2, 'name' => '李四', 'status' => 0],
['id' => 3, 'name' => '王五', 'status' => 1],
];
User::saveAll($data);- 每条子数组含
'id'（模型默认主键），且数据库中id=1/2/3已存在 → 逐条执行 UPDATE； - 若某条如
['id' => 999, ...]，但表中无id=999记录 → 仍会尝试 UPDATE，影响行为为 0 行，不报错，也不自动转 INSERT（除非显式启用replace）。
⚠️ 注意：
saveAll默认不会把“主键不存在”当作新增，它只按save()规则走 —— 实例化后调save()是新增，带主键查出来再save()是更新。而saveAll里没有“查出来”这步，所以仅靠主键字段存在 ≠ 自动更新成功，更不等于自动 fallback 到新增。立即学习“PHP免费学习笔记（深入）”；
❌ 主键字段名不匹配 → 全部当成新增
常见坑：前端传的是 'user_id' => 1，但模型主键定义是 'id'（或没显式设 pk）：
// 模型中未设置主键字段，或前端传错字段名 $data = [['user_id' => 1, 'name' => 'xxx']]; // user_id 不被识别为主键 User::saveAll($data); // → 全部当 INSERT，可能主键冲突或报错
解决方法：
- 确保数据中主键字段名和模型
protected $pk = 'id';完全一致； - 或显式指定主键字段：
User::pk('user_id')->saveAll($data);
? 显式控制每条数据行为（推荐复杂场景）
如果需要混合新增+更新，或规避自动判断风险，应不用依赖默认逻辑，改用：
-
replace()：主键存在则更新，不存在则插入（类似REPLACE INTO）User::replace()->saveAll($data); // 每条都走 replace 逻辑
-
手动分组处理：
$exists = User::where('id', 'in', array_column($data, 'id'))->column('id'); $updateData = array_filter($data, fn($d) => in_array($d['id'], $exists)); $insertData = array_filter($data, fn($d) => !in_array($d['id'], $exists)); User::saveAll($updateData); // 配合 isUpdate(true) 更稳妥 User::insertAll($insertData); // ThinkPHP 6.1+ 支持 insertAll（真批量 INSERT）
? 总结判断依据（单条数据级别）
- 含模型定义的主键字段（如
'id'），且值在库中存在 → 走更新（UPDATE） - 含主键字段，但值在库中不存在 → 仍走 UPDATE，影响行数为 0（不报错，也不插入）
- 不含主键字段（或字段名不匹配）→ 全部走新增（INSERT）
- 显式调用
->isUpdate(true)或->replace()→ 强制覆盖原有逻辑
saveAll本质是语法糖，底层仍是循环$model->save($item)。它的“判断”，就是每轮save()的判断，没有额外智能。
