ThinkPHP 的 saveAll 方法只接受二维关联数组，不支持模型对象数组；需用 getData() 或 toArray() 转换对象为数组后调用，支持主键存在则更新、不存在则新增，返回保存的对象数组或 false。
ThinkPHP 的 saveAll 方法用于批量保存模型数据，但**必须注意：它只接受数组形式的数据，不能直接传入已实例化的模型对象数组**。如果你手上有多个模型对象（比如通过 new User() 创建或查询后修改的实例），需先提取其属性为关联数组，再调用 saveAll。
saveAll 正确用法：传数组，不是模型对象
saveAll 是模型类的静态方法，底层会自动实例化新模型并批量写入。它要求参数是「二维关联数组」，每个子数组代表一条记录的字段值：
- 支持主键存在时更新、不存在时新增（类似
replace行为，取决于数据库配置和主键情况） - 不触发单个模型对象的
save()钩子（如beforeSave），但会触发模型的beforeWrite等静态事件 - 返回成功保存的模型对象数组（含自增 ID），失败返回
false
✅ 正确示例：
$data = [
['name' => '张三', 'email' => 'z3@example.com'],
['name' => '李四', 'email' => 'l4@example.com'],
];
$result = User::saveAll($data); // 返回两个 User 对象组成的数组
想用模型对象？先转成数组
如果你已有模型对象（比如从数据库查出后修改了部分字段），不能直接传对象数组。需手动提取数据：
立即学习“PHP免费学习笔记（深入）”；
- 用
$model->getData()获取当前属性（含修改后的值） - 用
$model->toArray()获取可序列化的数组（过滤掉 protected 属性） - 确保数组中包含主键字段（如
id），否则会被当作新增
✅ 示例（修改后批量保存）：
$users = User::where('status', 1)->select(); // 查出多个模型对象
$saveData = [];
foreach ($users as $user) {
$user->name = mb_substr($user->name, 0, 2) . '某'; // 修改字段
$saveData[] = $user->getData(); // 或 $user->toArray()
}
User::saveAll($saveData); // 批量更新/插入
注意事务与验证
saveAll 默认不开启事务，若需原子性，请手动包装：
- 用
Db::transaction()包裹saveAll调用 - 验证需提前做：它不会自动调用模型的
validate规则，除非你在模型中设置了protected $validate = true并在配置中启用（ThinkPHP 6.1+ 支持Validate场景） - 更稳妥的方式是先用
Validate类校验整个二维数组，再调用saveAll
替代方案：循环 save() 更可控
如果需要完整生命周期钩子（如 beforeSave、afterSave）、逐条处理异常、或混合新增/更新逻辑复杂，建议改用循环 + save()：
- 每个对象独立走验证、事件、自动时间戳等完整流程
- 可捕获单条失败，不影响其余数据
- 性能略低，但语义清晰、调试方便
✅ 示例：
$success = [];
foreach ($userObjects as $user) {
if ($user->save()) {
$success[] = $user;
}
}
