ThinkPHP 6.0 的 saveAll() 批量保存失败会导致部分数据写入而未回滚，本质是默认不启用事务，需用 Db::transaction() 包裹确保原子性，并分批处理、严格校验字段与主键映射。
ThinkPHP 6.0 的 saveAll() 在批量保存时出现“部分写入失败”，本质不是它支持“部分成功”，而是**某条记录出错导致整个批次中断，但已有数据已落库（若未加事务）**——这是最危险的情况。处理关键不在“重试”或“跳过”，而在于**提前拦截、明确边界、保障原子性**。
必须用事务包裹，且手动捕获异常
默认情况下，saveAll() 不自动开启事务。一旦第 3 条数据因主键冲突、字段超长、非空校验失败等报错，前 2 条可能已插入，后续数据不再执行，造成数据不一致。
- 正确做法：用
Db::transaction()包裹，确保全成功或全回滚 - 不能只依赖返回值判断：它返回的是模型对象集合，失败时抛异常而非返回 false
- 示例：
<?php
try {
Db::transaction(function () use ($data) {
(new User())->saveAll($data);
});
} catch (\Exception $e) {
// 记录日志、通知、或返回具体失败位置
throw $e;
}
逐条检查数据结构，重点核对主键和字段映射
saveAll() 判断新增/更新仅看数组中是否含主键字段（如 'id'），且字段名必须与模型定义的 $pk 完全一致。常见失败原因：
- 前端传
'user_id'，但模型protected $pk = 'id'→ 全部被当新增，触发主键重复 - 数据里混入了非法字段（如
'create_time'但数据库不允许 NULL，又没设默认值）→ 某条 INSERT 失败 - JSON 字段传了非数组/非字符串，或时间字段传了无效格式 → 验证层直接 throw
- 解决办法：导入前用
array_map()统一重命名键名；开启严格模式Db::setConfig(['strict' => true])提前暴露缺失主键
确认是否真需 saveAll()，还是该换 insertAll() 或原生 SQL
saveAll() 在 TP6 中仍是循环单条执行（非真正批量语句），500 条就可能因 MySQL 连接超时、PDO 参数超限、max_allowed_packet 报错。若业务不需要模型事件、验证、自动时间戳：
立即学习“PHP免费学习笔记（深入）”；
- 改用
Db::name('user')->insertAll($data)：轻量、快、内存低 - 但注意：
insertAll()不跳过重复、不自动填充时间戳、字段名必须严格匹配列名 - 若需“存在则更新、不存在则插入”，必须手拼
INSERT ... ON DUPLICATE KEY UPDATE，不能依赖saveAll(['replace'=>true])（它只是换 REPLACE INTO，且仍单条发）
分批 + 限流 + 日志定位，别让失败变黑盒
1000 条数据一起 saveAll() 失败，你根本不知道是哪一条、为什么错。应主动切片并记录上下文：
- 用
array_chunk($data, 200)分批，每批独立事务 - 每批执行前记录起始 key（如
batch_start: 401），失败时可快速定位范围 - 在 catch 中打印
$e->getMessage()和当前批次的首条数据样本，避免只看到 “SQLSTATE[23000]” 却不知哪条触发 - CLI 脚本记得调
gc_collect_cycles()防止内存累积
