hyperf测试中事务自动回滚无效,根本原因是db::transaction()仅在闭包内抛异常时回滚,而测试用例执行完连接断开导致mysql会话级事务被丢弃,并非自动回滚生效;必须显式在teardown阶段调用db::rollback(),且需配置pdo::attr_autocommit=>false并禁用连接池复用。

Hyperf 测试环境事务自动回滚为什么无效
Hyperf 的 DB::transaction() 默认不自动回滚——它只在闭包内抛出异常时才触发回滚,且仅限该闭包生命周期。测试中常见“插入数据后查不到”,不是因为自动回滚生效了,而是测试用例执行完连接断开、MySQL 会话级事务被自动丢弃(autocommit=1 下无事务上下文,根本没开启事务)。
Pytest + Hyperf 测试中如何强制事务回滚
不能依赖 MySQL 层的“断连自动回滚”,必须在测试框架层面控制。推荐做法是:每个测试用例独占一个数据库连接,并在 teardown 阶段显式调用 DB::rollBack(),而不是靠连接关闭。
- 确保测试前
DB::beginTransaction()已调用(不要用DB::transaction()闭包,它会在闭包结束时自动commit或rollback,无法跨方法延续) - 在
pytest的yield_fixture或finalizer中执行DB::rollBack() - 避免复用连接:Hyperf 的协程连接池默认复用连接,需为测试单独配置短生命周期连接或禁用连接池
- 示例关键片段:
def db_rollback_fixture(): DB::beginTransaction() yield DB::rollBack() # 确保无论成功失败都执行
MySQL 层 autocommit=0 不适用于 Hyperf 协程连接池
在 MySQL 客户端执行 SET autocommit=0 对 Hyperf 无效,因为协程连接池中的连接是预创建、复用的,不会继承你手动连接时的会话变量。Hyperf 的 Db 组件在获取连接时会重置会话状态(包括 autocommit),所以改 my.cnf 或 init_connect 也起不了作用。
-
init_connect='SET autocommit=0'仅对非 root 用户生效,且 Hyperf 连接通常用 root 或高权限账号,该配置会被忽略 - Hyperf 的
Db底层使用pdo_mysql,其PDO::ATTR_AUTOCOMMIT默认为true,必须在连接配置中显式设为false - 正确配置项是:
'options' => [PDO::ATTR_AUTOCOMMIT => false],加在config/autoload/databases.php的对应连接配置里
嵌套事务与 SAVEPOINT 在 Hyperf 测试中不可用
Hyperf 的 DB::transaction() 不支持嵌套,也不支持 SAVEPOINT。调用第二次 DB::transaction() 会直接报错 There is already an active transaction;而 DB::rollBackTo() 方法根本不存在——Laravel 和 Hyperf 的 Query Builder 均未封装保存点操作。
- 需要局部回滚?只能手写原生 SQL:
DB::statement('SAVEPOINT sp_name')和DB::statement('ROLLBACK TO SAVEPOINT sp_name') - 注意:
SAVEPOINT只在当前连接有效,协程切换可能导致连接变更,务必在同一线程内配对使用 - 测试中慎用:一旦某个测试忘了
RELEASE SAVEPOINT,后续测试可能因保存点名冲突而失败
事务回滚不是开关,是链路——从连接配置、框架封装、协程调度到 MySQL 会话状态,每一环都可能让“自动”失效。最稳的方式,是把回滚动作写死在测试 teardown 里,而不是期待某一层替你兜底。











