ThinkPHP 的 saveAll 方法用于批量新增或更新数据，根据主键是否存在决定执行 INSERT 或 UPDATE；成功返回模型实例数组，失败返回 false；支持验证、事务及主键自定义。
ThinkPHP 的 saveAll 方法用于批量保存（新增或更新）多个数据，常用于表单提交多条记录、Excel 导入等场景。它本质是循环调用模型的 save()，但会自动处理主键存在与否：有主键值则尝试更新，无主键值则插入。
基本写法（数组方式）
传入一个二维数组，每项是一条记录的数据：
$data = [
['name' => '张三', 'email' => 'z3@example.com'],
['name' => '李四', 'email' => 'l4@example.com'],
['id' => 5, 'name' => '王五', 'email' => 'w5@example.com'], // id 存在 → 更新
];
$result = User::saveAll($data);
✅ 成功时返回包含所有保存后模型实例的数组；失败时返回 false，可通过 User::getError() 获取错误信息。
支持对象数组和关联属性
也可以传入模型对象数组，并可开启自动验证、自动完成等：
立即学习“PHP免费学习笔记（深入）”；
- 默认开启验证（需模型中定义
validate规则） - 支持
auto和filter等自动处理 - 如需跳过验证，加参数：
User::saveAll($data, ['validate' => false])
注意主键与更新逻辑
saveAll 判断更新/插入仅看「主键字段是否在数据中且非空」，不查数据库是否存在该记录：
-
['id' => 10, 'name' => 'abc']→ 执行UPDATE ... WHERE id = 10（不管 id=10 是否真实存在） -
['name' => 'xyz']→ 执行INSERT - 若想“有则更新、无则插入”，应使用
replace或upsert（TP6.1+ 支持upsert）
常见问题处理
遇到失败时建议逐条调试：
- 检查数组结构是否为二维，且每项字段名正确
- 确认主键字段名（默认
id，如为user_id需在模型中设置pk = 'user_id'） - 事务包裹更安全：
Db::transaction(function () use ($data) { User::saveAll($data); }); - TP6 中
saveAll返回结果含isUpdate()可判断每条是新增还是更新
