saveAll是语义批量而非SQL批量，逐条调用save()并走完整生命周期；适用于≤100条、需验证/事件/自动填充的场景；大批量应分块+事务+关闭验证。
ThinkPHP模型的saveAll不是真正意义上的“批量SQL”，而是语义上的批量——它会逐条调用save()，每条数据都走一次完整模型生命周期。适合小批量、需验证/事件/自动填充的场景，不追求极致性能时可用。
什么时候该用 saveAll
它适用于以下情况：
- 数据量明确 ≤ 100 条，比如后台表单提交的多行配置或用户导入（非万级）
- 需要自动时间戳（
create_time/update_time）、自动写入、类型转换等模型能力 - 依赖验证器规则，且失败时要求整批回滚（而非部分插入）
- 需触发
before_insert、after_save等模型事件，例如记录操作日志 - 主键非自增（如 UUID），且希望返回完整对象实例（含 ID）
基础写法与关键细节
必须用模型实例调用，不能静态调用：
$user = new User(); $result = $user->saveAll($data);
注意：
立即学习“PHP免费学习笔记（深入）”；
-
$data是二维数组，每个子数组键名需与模型定义的字段名严格一致（如模型设protected $pk = 'id'，数据里就得有'id' => 123，不能是'user_id'） - 默认开启验证，若数据已清洗干净，加
['validate' => false]可显著提速 - 主键为自增时，
$result是包含新ID的对象数组，可通过$result[0]->id取值；非自增则返回true/false - 字段若不在模型
$schema或数据库中，会被静默丢弃，不报错
处理大批量数据的正确姿势
5000 条直接传给saveAll，等于发 5000 次 SQL、初始化 5000 次模型、执行 5000 次验证——极易超时或内存溢出。应：
- 用
array_chunk($data, 400)分块，每批控制在 200–500 条 - 复用同一个模型实例：
$model = new User(); foreach ($chunks as $chunk) { $model->saveAll($chunk); } - 每块包裹事务：
Db::transaction(fn() => $model->saveAll($chunk)); - 关闭验证：
$model->validate(false)->saveAll($chunk) - CLI 脚本中记得
gc_collect_cycles()和set_time_limit(0)
别踩这些坑
常见错误包括：
- 误以为
saveAll生成单条 INSERT 语句——它不会，Db::insertAll()才会 - 在事务中混用
saveAll()和Db::insertAll()——可能因连接实例不同导致事务失效 - 数据中混入主键冲突记录（如重复
id），整个批次报错；此时应先查重或改用replace逻辑 - 用
User::saveAll($data)静态调用（TP6 不支持，会报错） - 未清理非法字段，TP5.1 遇到不存在字段直接报错，TP6 则默认过滤
