asyncpg事务回滚不生效的根本原因是Transaction对象未被正确await或提前退出作用域,它不支持async with自动管理,必须显式await tx.rollback(),且需在try/except/finally中确保执行,否则事务挂起导致脏数据。

asyncpg 事务回滚为何不生效?
根本原因通常是 asyncpg 的事务对象(Transaction)未被正确 await 或提前退出作用域。它不是上下文管理器自动 commit/rollback,而是依赖显式 await tx.commit() 或 await tx.rollback();如果异常发生但没走到 rollback(),或事务对象被垃圾回收(比如函数返回后),事务就卡在 pending 状态,后续连接可能复用该连接并看到“未提交的脏数据”,看似回滚失效。
- 务必用
try/except/finally包裹事务块,且rollback()必须在except和finally中都考虑 —— 否则异常跳过 rollback 语句 - 不要依赖
__aexit__自动回滚:asyncpg 的Transaction没有实现异步上下文协议,async with conn.transaction():会报AttributeError: __aexit__ - 避免在事务中调用未 await 的协程(如忘记
await conn.execute(...)),这会导致事务对象未真正执行 SQL,但状态已变更,rollback 可能无效果
SQLAlchemy 2.0+ async session 回滚失败的典型场景
使用 AsyncSession 时,session.rollback() 是协程,必须 await;而很多人误以为它像同步版一样是普通方法,直接调用导致回滚被忽略,数据库仍保留未提交更改。
-
await session.rollback()是必须的,不能省略await—— 否则只是创建了一个未执行的 coroutine 对象 - 事务生命周期绑定
AsyncSession实例,若在rollback()前已调用await session.close(),再 rollback 会抛InvalidRequestError: This session is closed - 批量操作中混合了
session.add()和原始await conn.execute()(绕过 ORM),此时session.rollback()不影响 raw SQL 的事务状态,需统一用 session 执行或手动管理底层 connection
连接池复用导致“回滚后数据还在”的错觉
这不是回滚失效,而是连接池(如 asyncpg.Pool 或 SQLAlchemy 的 AsyncEngine)复用了上一个事务未清理干净的连接。例如前一次事务异常未 rollback,连接被放回池中,下一次获取该连接时,其事务状态仍是 active,新查询可能读到残留的 uncommitted 数据。
- 启用连接池的
reset配置:asyncpg Pool 初始化时加init=conn.reset(conn.reset()会清理事务和会话状态) - SQLAlchemy 中设置
pool_pre_ping=True+pool_recycle=3600,避免陈旧连接复用;更关键的是确保每次异常后都await session.rollback()并await session.close() - 调试时可在事务开始前加
await conn.execute("SELECT pg_backend_pid()")打印 backend PID,确认是否真复用了同一连接
测试环境里事务隔离级别引发的验证偏差
本地测试常用 SQLite 或内存数据库,但它们对异步事务支持有限,且默认隔离级别(如 SQLite 的 DEFERRED)不保证跨连接可见性。你在测试里“查不到回滚后的数据”,可能只是因为没开新连接去验证,而非回滚没执行。
立即学习“Python免费学习笔记(深入)”;
- 单元测试中,每个测试应使用独立连接或 session,避免共享事务状态;pytest fixture 中用
scope="function"确保隔离 - 别用
sqlite+aiosqlite测复杂事务逻辑——它不支持真正的并发事务,回滚行为与 PostgreSQL 差异极大 - 验证回滚是否生效,必须从另一个连接(非事务内)查询,而不是在同一个
conn上fetchall()—— 同一连接能看到未提交变更,这是正常行为


















