Autobegin与Session.begin的区别及无begin时不提交的疑问

核心差异：Session 上下文 vs 事务上下文 #

你遇到的问题本质是混淆了Session的上下文管理器和事务的上下文管理器的作用：

• with Session(engine) as session：这个上下文仅负责在退出时关闭Session，不会自动提交事务。
• session.begin()：它返回的是一个事务上下文管理器，当这个上下文退出时，若没有异常则自动提交事务，有异常则回滚。你第一个代码里的with Session(...) as session, session.begin()是同时启用了两个上下文：Session的生命周期管理，以及事务的自动提交/回滚。

对 Autobegin 特性的理解偏差 #

文档里说的「Session具备autobegin特性」，意思是：当你执行第一个需要数据库交互的操作（比如session.add()触发的flush、查询等）时，Session会自动开启一个事务，不需要你手动调用session.begin()来启动事务。但这仅仅是「自动开启」，不是「自动提交」——事务开启后，必须显式提交（session.commit()），或者通过事务上下文管理器（即session.begin()的with块）来自动处理提交，否则Session在关闭时会自动回滚未提交的事务。

代码行为对比 #

1. 带session.begin()的代码：

   with Session(engine) as session, session.begin():
       session.add(Foo(id=1))
   

   这里的session.begin()上下文在退出时，因为无异常，自动提交事务；随后Session上下文关闭Session，数据成功写入。

2. 不带session.begin()的代码：

   with Session(engine) as session:
       session.add(Foo(id=1))
   

   Autobegin确实在session.add()触发flush时自动开启了事务，但退出Session上下文时，Session发现存在未提交的事务，会自动回滚，所以数据没有保存。如果要让这段代码提交，需要手动添加session.commit()：

   with Session(engine) as session:
       session.add(Foo(id=1))
       session.commit()
   

补充说明 #

Session.begin()的文档没提提交，是因为提交/回滚是它返回的事务上下文管理器的行为，而非Session.begin()方法本身的直接作用——这个方法的主要作用是启动事务，并返回用于管理事务生命周期的上下文对象。

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