根本原因在于事务状态绑定于协程私有的数据库连接,该连接不可跨协程共享;MySQL只认连接句柄,协程切换不传递事务上下文,强行传递会导致并发冲突、状态污染与连接泄漏。

协程内数据库事务不能跨协程执行,根本原因在于:事务状态绑定在数据库连接(PDO/MySQLi 实例)上,而该连接在 Swoole 协程环境下是**协程私有、不可共享**的资源。
事务依赖连接,连接绑定协程
MySQL 的事务(BEGIN/COMMIT/ROLLBACK)不是独立存在的逻辑单元,它必须依附于一个活跃的数据库连接。一旦执行 BEGIN,连接就进入“事务模式”,后续所有 SQL 都在该上下文中生效;直到 COMMIT 或 ROLLBACK 才释放事务状态。
在 Swoole4 协程中,每个协程默认使用自己独占的数据库连接(尤其在配合 pdo_mysql + Swoole\Runtime::enableCoroutine() 时)。这个连接在协程 yield 时被挂起,协程 resume 时继续使用——但绝不会被其他协程复用或接管。
所以当你在协程 A 中执行 BEGIN,事务只对协程 A 的连接生效;若此时协程 B 也拿到一个连接(哪怕来自同一连接池),它的任何操作都与协程 A 的事务完全无关。
协程切换不传递事务上下文
协程调度是用户态的轻量级切换,不涉及操作系统进程/线程上下文的完整保存与恢复。数据库驱动层(如 PDO)没有为协程设计事务状态透传机制。也就是说:
- 协程 A 中开启事务后 yield,控制权交给协程 B;
- 协程 B 执行自己的 SQL,它用的是自己的连接,自然不在 A 的事务里;
- 协程 A resume 后继续执行,仍用原连接,事务上下文还在;
- 但协程 B 的操作从未被纳入 A 的事务范围,也无法被 A 的 COMMIT 影响。
这不是 bug,而是协程模型与数据库协议天然隔离的结果——MySQL 不知道你在用协程,它只认连接句柄。
为什么不能手动“传递”连接?
有人尝试把协程 A 的 PDO 对象传给协程 B 使用,这会导致严重问题:
-
并发冲突:PDO 实例不是线程/协程安全的,多协程同时调用
query()可能导致底层 MySQL 协议包错乱; -
状态污染:一个连接在同一时刻只能处于一种事务状态(无事务 / 事务中 / 准备提交),多个协程交替操作会覆盖彼此的
autocommit、transaction isolation等设置; - 连接泄漏:协程销毁时若未显式关闭连接,而该连接又被其他协程持有,容易造成连接池耗尽。
因此,Swoole 官方和主流协程数据库封装(如 Hyperf DB、Swoole\Table + 连接池)都强制要求:每个协程获取连接 → 执行完整业务逻辑(含事务)→ 归还连接,全程闭环。
正确做法:单协程内完成事务全生命周期
要保证原子性,必须把需要事务保护的操作全部放在同一个协程内同步执行(注意:是逻辑同步,不是阻塞等待):
- 开启事务(
$pdo->beginTransaction()); - 执行所有相关 SQL(插入订单、扣库存、写日志等);
- 统一判断结果,决定
commit()或rollback(); - 整个过程不主动 yield 到其他协程(除非你确认底层驱动已做协程安全封装且支持事务延续,目前主流不支持)。
若业务逻辑天然分散(如需调用下游 HTTP 接口),应改用最终一致性方案:本地事务提交后,通过消息队列(RabbitMQ)、事件总线或 Saga 模式补偿,而不是强行跨协程保事务。











