SQLAlchemy设置autocommit=True的Session未提交数据问题排查

核心逻辑：ORM Session的autocommit=True并非自动提交所有变更 #

SQLAlchemy中ORM Session的autocommit=True机制和直观理解的“自动提交所有变更”有本质区别：

• session.add()仅将对象加入Session的本地缓存，不会立即触发数据库插入操作，必须通过flush()（把缓存同步到数据库）或commit()才能让变更进入数据库。
• 在autocommit=True模式下，只有当触发数据库操作（如flush）且无活跃事务时，才会自动提交该操作。但仅调用session.add()不会触发flush，所以变更一直停留在本地缓存，从未写入数据库。

为什么with块结束后数据没保存？ #

使用with S2() as session:的上下文管理器时：

• 对于默认（autocommit=False）的Session，上下文管理器退出时会自动执行session.commit()，而commit()会先触发flush()再提交事务，因此数据能保存。
• 但对于autocommit=True的Session，上下文管理器不会自动执行commit()（因为autocommit模式下Session默认不维护长期事务），且你没有手动触发flush或commit，当Session关闭时，本地缓存的变更被直接丢弃，数据自然无法保存。

你可以通过以下两种方式让autocommit=True的Session正常保存数据：

1. 手动触发flush：在session.add(test2)后添加session.flush()，此时autocommit机制会自动提交这个flush操作：

with S2() as session:
    test2 = Testing(name="Johnny", comment="test2")
    session.add(test2)
    session.flush()

2. 手动调用commit：即使开启autocommit，手动调用session.commit()依然有效，它会触发flush并提交：

with S2() as session:
    test2 = Testing(name="Johnny", comment="test2")
    session.add(test2)
    session.commit()

额外说明：ORM的autocommit=True更适合无事务需求的单次数据库操作场景（比如单独查询、简单插入）。如果是批量操作，建议使用默认事务模式（autocommit=False），通过显式commit控制事务边界。

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