SQLAlchemy查询返回会话缓存值而非数据库实际值如何解决

问题核心原因 #

这是SQLAlchemy会话的**身份映射（Identity Map）**机制导致的：同一个会话中，相同主键的实体对象只会保留一份实例，你发起实体查询时，只要会话缓存里已经存在对应主键的对象，默认会直接返回该内存对象，不会用数据库返回的最新值覆盖它，哪怕你加了with_for_update也不会触发属性更新。autoflush=False只控制查询前是否将会话未提交变更刷到数据库，和查询返回时是否读取缓存对象无关，因此无法解决这个问题。

解决方案 #

方案1：强制覆盖会话缓存（需要同步内存值时使用） #

在查询链中加入populate_existing()方法，强制SQLAlchemy用数据库查询到的最新值覆盖会话中已存在的同主键对象的所有属性，你拿到的就是数据库真实值，同时保留行锁：

check : ClockStatus = self.database.session.query(Bot)\
    .filter(Bot.id == self.id)\
    .with_for_update(nowait=False)\
    .populate_existing()\
    .first().clock

注意：该方法会修改当前会话中self对象的clock属性为数据库中的旧值，适合后续需要同步内存和数据库状态的场景。

方案2：直接查询字段（不需要修改内存对象时使用） #

如果你只想读取数据库的clock字段值，不希望修改内存中self对象的现有属性，可以直接查询字段而非整个Bot实体，该操作会绕过身份映射，直接返回数据库原始值：

check : ClockStatus = self.database.session.query(Bot.clock)\
    .filter(Bot.id == self.id)\
    .with_for_update(nowait=False)\
    .scalar()

这个方案不会改动当前会话中已加载的Bot对象属性，更符合你需要先读取旧值再自行做同步的需求。

方案3：临时新开会话（完全隔离操作时使用） #

如果你的查询逻辑需要和当前会话完全隔离，可以创建一个临时会话执行查询，临时会话的缓存和当前会话完全独立，自然会返回数据库最新值：

# 临时会话用完记得关闭，避免连接泄漏
with self.database.session_factory() as temp_session:
    check : ClockStatus = temp_session.query(Bot.clock)\
        .filter(Bot.id == self.id)\
        .with_for_update(nowait=False)\
        .scalar()

注意：不同会话的行锁会互相阻塞，需要根据业务逻辑控制事务生命周期，避免死锁。

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