FastAPI-AsyncPG-SQLAlchemy报错：无法在手动事务中调用Connection.transaction()

这个报错的核心是连接池中的连接被意外留在了未结束的事务状态，即便你没手动启动事务，也可能因为以下情况触发：

• 异常未被正确处理：请求处理过程中抛出未捕获的异常时，SQLAlchemy默认的自动事务机制（每个请求会自动开启事务）没有机会完成提交或回滚，连接被放回连接池时仍处于事务中。后续请求复用这个连接时，再尝试开启新事务就会触发冲突报错。
• 会话管理逻辑不严谨：模板的数据库会话依赖注入（比如get_db这类函数）可能存在漏洞，比如异步场景下finally块中仅关闭会话，但没确保事务已结束；或者会话清理时未处理异常导致事务残留。
• 隐性事务残留：虽然你没手动调用事务，但某些ORM操作（如批量写入、关联更新）内部会触发事务，加上SQLAlchemy默认autocommit=False，如果请求结束时没显式提交或回滚，连接会带着未完成的事务回到池里。

排查建议 #

• 检查所有请求处理的异常捕获逻辑，确保每个请求的数据库会话在结束前，无论是否发生异常，都执行await session.commit()或await session.rollback()。
• 查看模板的数据库会话管理代码，确认在异步环境下，会话关闭前已正确处理事务状态，比如在try/except/finally块中：

  async def get_db():
      async with AsyncSessionLocal() as session:
          try:
              yield session
              await session.commit()
          except Exception:
              await session.rollback()
              raise
          finally:
              await session.close()
  

• 可以在会话关闭前添加日志，打印会话的事务状态（如session.in_transaction()），定位哪些请求结束后事务未正常终止。

内容的提问来源于stack exchange，提问作者user3900157