CakePHP的saveMany()默认不开启事务，因底层循环调用单条save()且无事务上下文，部分失败时已成功记录无法回滚；必须用getConnection()->transactional()包裹并透出异常才能保证原子性。
CakePHP 的 saveMany() 默认不开启事务，部分失败时不会自动回滚 —— 必须手动包裹事务控制逻辑，否则极易产生脏数据。
为什么 saveMany() 不保证原子性
CakePHP 3.x/4.x 的 Table::saveMany() 底层是循环调用单条 save()，每条记录独立执行 INSERT/UPDATE，不共享事务上下文。即使某条失败，前面成功的记录已写入数据库，后续也不会被撤销。
- 它不自动调用
$table->getConnection()->begin()，也不捕获异常后回滚 - 返回值只反映“最后一条是否成功”，不表示整体结果（例如 5 条中前 4 条成功、第 5 条失败，
saveMany()返回false，但前 4 条已落库） - 若表使用 MyISAM 引擎，事务根本不可用 —— 务必确认引擎为 InnoDB
正确做法：用 getConnection()->transactional() 包裹
CakePHP 提供了安全的事务封装方法 transactional()，它会自动处理 begin/commit/rollback，并将异常透出。这是最简且可靠的方式。
- 必须把整个
saveMany()调用放在transactional()的闭包内 - 闭包中抛出的任何异常（包括
saveMany()内部验证失败、DB 约束冲突等）都会触发回滚 - 不要在闭包里自己 try/catch 吞掉异常，否则事务无法感知失败
use Cake\ORM\TableRegistry;
$articles = TableRegistry::get('Articles');
$data = [
['title' => 'First', 'body' => '...'],
['title' => 'Second', 'body' => '...'],
['title' => 'Third', 'body' => '...'],
];
try {
$articles->getConnection()->transactional(function () use ($articles, $data) {
$entities = $articles->newEntities($data);
$result = $articles->saveMany($entities);
if (!$result) {
// saveMany 返回 false 表示至少一条失败 → 主动 throw 触发回滚
throw new \RuntimeException('Failed to save some articles');
}
});
} catch (\Exception $e) {
// 事务已回滚，这里只做日志或通知
error_log('Batch save failed: ' . $e->getMessage());
}
遇到唯一索引冲突或验证失败怎么办
常见错误如 Integrity constraint violation: 1062 Duplicate entry 或实体验证失败（entity->getErrors() 非空），这些都会中断 saveMany()，但默认不回滚。
立即学习“PHP免费学习笔记（深入）”；
-
saveMany()遇到第一条失败就停止，不会继续处理后续记录 —— 所以你只能拿到部分结果 - 若需“跳过失败项、保存其余”，就不能依赖
saveMany()原语，得改用循环 + 单条save()+ 手动事务 + 错误收集 - 但注意：手动循环中每条
save()若都走事务，性能极差；应在外层开一次事务，循环内只做save()，靠外层统一 commit/rollback
容易忽略的连接状态问题
事务回滚后，PDO 连接可能处于不稳定状态（尤其发生死锁或超时后），紧接着再调用 saveMany() 或查询可能直接报错，比如 SQLSTATE[HY000]: General error。
- 不要复用同一个
Table实例在回滚后立刻发起新操作 - 稳妥做法：回滚后重建连接，或让上层逻辑重试时新建
Table实例 - 可在 catch 块末尾加
$articles->getConnection()->disconnect();强制释放（CakePHP 4.4+ 支持）
