cakephp 不支持真正嵌套事务，须手动执行 savepoint 实现逻辑嵌套与局部回滚；必须在 transaction() 开启的同一连接中调用 execute('savepoint ...')，命名需合法且唯一，回滚后可继续执行其他操作，最终由外层自动 commit。
CakePHP 本身不支持真正的嵌套事务，但可以通过原生 SAVEPOINT 实现“逻辑嵌套”和部分回滚——关键不是靠框架封装，而是你主动控制 SQL 级别语句，并确保在同一个数据库连接内执行。
为什么 CakePHP 没有内置 savepoint API
CakePHP 的 Connection::transaction() 底层调用的是 PDO 的 beginTransaction() / commit() / rollback()，而 PDO 不暴露保存点接口。这意味着：框架不会帮你生成或管理 SAVEPOINT sp_name，也不会拦截 ROLLBACK TO SAVEPOINT。所有保存点操作必须手动发 SQL，且必须在已开启的事务中执行。
- 调用
Connection::transaction()后，连接处于事务模式，此时才能用execute('SAVEPOINT ...') - 若在非事务上下文中执行
SAVEPOINT，MySQL 会报错ERROR 1305 (42000): SAVEPOINT does not exist（实际是“无事务可设”） - 不要依赖
Table::save()自动参与保存点——它只是普通 INSERT/UPDATE，是否被回滚取决于你何时执行ROLLBACK TO SAVEPOINT
在 CakePHP 中安全使用 SAVEPOINT 的实操步骤
以订单创建为例：主表插入成功后，再批量插入明细；若某条明细失败，只回滚明细，保留主表记录。
- 用
$connection->transaction()包裹整个流程，确保连接复用 - 主表保存后立即执行
$connection->execute('SAVEPOINT order_details') - 循环插入明细，每条用
$query->insert()->values(...)->execute()或$table->save($entity) - 捕获异常时，执行
$connection->execute('ROLLBACK TO SAVEPOINT order_details')，然后继续后续逻辑（如发通知、记日志） - 最终由外层
transaction()自动COMMIT——注意：它提交的是保存点之后仍存活的修改
示例片段：
$connection = ConnectionManager::get('default');
$connection->transaction(function ($connection) {
$orders = TableRegistry::get('Orders');
$order = $orders->newEmptyEntity();
$order = $orders->patchEntity($order, ['status' => 'pending']);
$orders->save($order); // 主表已写入
$connection->execute('SAVEPOINT order_details');
try {
$details = TableRegistry::get('OrderDetails');
foreach ($items as $item) {
$detail = $details->newEmptyEntity();
$detail = $details->patchEntity($detail, $item);
$details->save($detail);
}
} catch (\Exception $e) {
$connection->execute('ROLLBACK TO SAVEPOINT order_details');
// 此处可记录明细失败，但订单主记录仍有效
}
// 其他操作，如更新库存、发消息等...
});
命名与兼容性避坑要点
保存点名不是随便起的字符串，它要符合 SQL 标识符规则，且在 MySQL 中不能含引号、空格、连字符或数字开头。
- 错误写法：
$connection->execute("SAVEPOINT 'sp_order_{$id}'")（带单引号 → 语法错误） - 错误写法：
$connection->execute("SAVEPOINT sp-order-1")（含连字符 → 解析失败） - 推荐命名：
sp_order_create、sp_payment_attempt，小写+下划线+业务前缀 - 重复命名会静默覆盖前一个保存点，所以不要在循环里用固定名（如
sp1），否则第二次SAVEPOINT sp1会让第一次失效 - MySQL 遇到 DDL（如
ALTER TABLE）会隐式提交事务，所有保存点立刻消失——避免在事务中执行迁移类操作
释放保存点与事务结束的边界
RELEASE SAVEPOINT 不是必须的，但建议在确认不再需要某个保存点时显式释放，尤其当事务较长、保存点较多时。
-
$connection->execute('RELEASE SAVEPOINT order_details')仅删除该保存点，不影响数据或事务状态 - 一旦执行
COMMIT或ROLLBACK（无目标），所有保存点自动清除，无需手动释放 - 如果回滚到保存点后又执行了新 SQL，可以再设新保存点，但名字不能和现存的冲突
- 最易忽略的一点：回滚到保存点后，被撤销语句涉及的行级锁通常释放，但如果你之前手动加了表锁（
LOCK TABLES），它不会自动释放——CakePHP 不处理这类底层锁，得你自己收尾
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
