如何禁用SQLAlchemy懒加载？Flask-SQLAlchemy关联查询重复执行问题

问题核心原因 #

• 显式调用join搭配joinedload产生了冲突：joinedload本身会隐式生成左连接查询关联表，重复的join逻辑加上复合主键的映射校验，会导致ORM无法识别已加载的关联对象，访问属性时触发二次查询。
• 多对一关系未显式指定复合外键：你仅配置了表级的外键约束，但Event.user关系没有声明关联的外键字段，ORM无法正确对齐复合主键的关联映射，导致之前设置的lazy="joined"也无法生效。

解决方法 #

方案1：仅用joinedload实现预加载 #

删掉显式的join语句，直接使用joinedload即可完成关联加载，访问user属性不会触发二次查询：

from sqlalchemy.orm import joinedload

events = Event.query.filter(Event.timestamp == day)
.options(joinedload(Event.user))
.all()

方案2：显式join搭配contains_eager #

如果你需要对UserEntity表加过滤条件，必须显式写join的场景，改用contains_eager告知ORM直接从已关联的查询结果中提取关联对象即可：

from sqlalchemy.orm import contains_eager

events = Event.query.filter(Event.timestamp == day)
.join(Event.user)
# 可在此处添加UserEntity的过滤条件，例：.filter(UserEntity.gender == 'male')
.options(contains_eager(Event.user))
.all()

修复关系映射让lazy配置生效 #

修改Event的user关系定义，显式指定关联的外键字段，此时设置lazy="joined"即可全局默认对该关系走预加载，不需要每次查询加options：

class Event(db.Model):
    # 原有字段定义不变
    user = db.relationship(
        "UserEntity",
        foreign_keys=[username, userfirstname],
        lazy="joined" # 开启后默认预加载user，不需要额外配置查询选项
    )

全局懒加载控制 #

如果需要全局禁用懒加载（开发阶段推荐开启，避免遗漏预加载逻辑），可以在初始化SQLAlchemy时添加session配置，触发懒加载时直接抛出异常：

db = SQLAlchemy(
    app,
    session_options={
        "lazyload": "raise"
    }
)

不推荐全局强制所有关联走joined加载，会导致不必要的多表关联查询降低性能，建议针对单个关系按需设置lazy参数更合理。

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