SQLAlchemy async版lazy='raise'下已joinedload字段仍触发懒加载错误

这个现象的核心是SQLAlchemy Session的**一级缓存（身份映射 Identity Map）**机制：

• 同一个Session生命周期内，只要是主键相同的同模型实体，只会保留一份实例对象，后续所有查询命中相同主键的记录时，都会直接返回缓存中已有的实例，不会重新生成新对象。
• 你先执行User查询时，通过joinedload(User.user_groups)已经把主键为1的UserGroup实例加载到了缓存中，这次查询只预加载了UserGroup.privileges，没有加载UserGroup.organization。
• 后续你单独查询主键为1的UserGroup时，虽然指定了joinedload(UserGroup.organization)，但SQLAlchemy发现缓存中已经存在该实例，就直接返回了缓存里的旧实例，你指定的joinedload规则没有生效，旧实例本身没有加载organization属性，所以访问就触发了lazy='raise'的报错。
• 为什么给User查询加上User->UserGroups->Organization的加载规则就正常？因为这时候第一次加载UserGroup到缓存时就已经预加载了organization属性，后续不管从哪里拿到这个实例都能正常访问。

有几种可落地的方案，按推荐优先级排序：

• 方案1：查询时添加populate_existing选项，强制覆盖缓存实例
  单独查询UserGroup时，加上populate_existing()配置，强制SQLAlchemy从数据库重新拉取数据，覆盖缓存中实例的属性，你指定的joinedload规则就会生效：

  user_group = await self.db.get(UserGroup, 1, [joinedload(UserGroup.organization), populate_existing()])
  

  这个方案对现有代码侵入最小，也不会产生多余的关联查询。
• 方案2：调整查询顺序
  把单独查询UserGroup的逻辑移到User查询之前，这样缓存中先存入带organization属性的UserGroup实例，后续User查询关联取到的也是这个完整实例，不会出现属性缺失。
• 方案3：封装复用加载规则
  针对常用的实体关联预加载需求，可以把加载选项封装为常量，避免重复编写冗余代码：

  # 提前封装好UserGroup的常用预加载配置
  USER_GROUP_BASE_OPTIONS = [joinedload(UserGroup.organization), joinedload(UserGroup.privileges)]
  # 使用时直接引用
  user_group = await self.db.get(UserGroup, 1, [*USER_GROUP_BASE_OPTIONS, populate_existing()])
  

• 方案4：按需使用独立Session
  如果不同查询逻辑之间没有事务关联性，可以为独立的查询逻辑创建新的Session，避免不同查询之间的缓存互相干扰，不过这个方案需要注意事务一致性的问题，适合纯读的场景。

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