saveAll通过主键字段存在性判断新增或更新：有有效主键且数据库存在则更新，否则新增；主键名须与模型$pk定义完全一致，如$id='id'则必须传'id'=>123而非'user_id'=>123。
saveAll 本身支持“自动识别新增或更新”，但不是靠数据内容智能判断，而是严格依赖主键字段是否存在且有效。它能同时新增和更新，前提是：你传入的每条数据里，主键字段（如 id）必须准确、一致、可识别。
主键字段必须和模型定义完全匹配
ThinkPHP 判断一条记录是新增还是更新，只看两点：
- 数据中是否包含模型定义的主键字段（查
protected $pk = 'id';） - 该字段值在数据库中是否存在对应记录
比如模型设了 $pk = 'id'，你就必须传 'id' => 123，不能传 'user_id' => 123 或 'uid' => 123 —— 否则系统认为“没主键”，全部当作新增插入。
✅ 正确示例：
立即学习“PHP免费学习笔记（深入）”；
$data = [
['id' => 1, 'name' => '张三', 'status' => 1],
['id' => 2, 'name' => '李四', 'status' => 0],
['name' => '王五', 'status' => 1], // 没 id → 新增
];
User::saveAll($data);→ id=1 和 id=2 的记录被更新，第三条无 id → 新增。
如何确保混合操作不出错
- 确认模型类中
$pk值，例如protected $pk = 'id'; - 所有要更新的数据，必须带这个字段，且值真实存在
- 新增数据不带该字段，或显式设为
null/0（非自增主键需谨慎） - 避免字段别名混淆：前端传
user_id，后端需提前映射成id
可以加一层预处理：
foreach ($data as &$item) {
if (isset($item['user_id'])) {
$item['id'] = $item['user_id'];
unset($item['user_id']);
}
}注意几个常见翻车点
- 传了
'id' => 0或'id' => ''：多数情况下仍被当新增（尤其主键是自增 int），因为数据库查不到 id=0 的记录 - 主键是字符串（如 UUID）：确保传入的是完整、合法的字符串值，且数据库已存在
- 使用了软删除：
saveAll不会跳过delete_time IS NULL的逻辑，更新时若记录已被软删，需先恢复或手动处理 - 开启了验证器：任意一条数据验证失败，整个
saveAll中断返回false，不会部分成功
想强制走更新或新增？
- 强制更新：
$model->isUpdate(true)->saveAll($data) - 强制新增：
$model->isUpdate(false)->saveAll($data)
⚠️ 但isUpdate()是全局开关，对整批生效，无法逐条控制。真要混用且精细控制，建议拆成两组：一组带主键的走saveAll（更新），一组不带的另起saveAll（新增），或改用Db::insertAll()+Db::update()组合。
不复杂但容易忽略。
