SQLAlchemy关联查询重复JOIN：保留joinedload同时优化SQL输出

这个问题我之前也踩过坑，根源很明确：你在Author.books关系里设置了lazy='joined'，这会让SQLAlchemy自动给每个Author查询添加一次JOIN来预加载books数据；而当你手动调用outerjoin(Author.books, Page)时，又会额外生成一次JOIN，最终就导致SQL里出现了两次authors和books的关联操作。

下面给你几个可行的解决方案，根据你的实际需求选就行：

方案1：用contains_eager复用手动JOIN（保留预加载） #

如果你想在这次查询中同时关联Page，并且还要保留books的预加载，那可以用contains_eager告诉SQLAlchemy：“我已经手动做了JOIN，直接用这个结果填充关系属性就行，别再自动加JOIN了”。

修改后的查询代码如下：

from sqlalchemy.orm import contains_eager

# 先JOIN books，再JOIN pages，然后用contains_eager关联两层关系
query = session.query(Author)\
    .outerjoin(Author.books)\
    .outerjoin(Book.pages)\
    .options(contains_eager(Author.books).contains_eager(Book.pages))

print(str(query))

这样生成的SQL只会有一次authors和books的JOIN，同时还能预加载books和对应的pages数据。

方案2：临时禁用默认的joinedload #

如果这次查询不需要预加载books（只是要关联Page），但其他地方还要保留lazy='joined'的默认行为，可以用lazyload临时覆盖默认的预加载策略：

from sqlalchemy.orm import lazyload

query = session.query(Author)\
    .outerjoin(Author.books, Page)\
    .options(lazyload(Author.books))

print(str(query))

这个方法会让SQLAlchemy在这次查询中跳过自动JOIN books，只执行你手动添加的outerjoin，生成的SQL就正常了。

方案3：调整全局lazy策略，按需手动预加载 #

如果lazy='joined'不是全局必须的（大部分查询不需要自动预加载books），更灵活的做法是把默认lazy改成select，然后在需要预加载的地方手动用joinedload：

首先修改Author类的关系定义：

class Author(Base):
    __tablename__ = 'authors'
    # ... 其他字段 ...
    books = relationship("Book", lazy='select')  # 改成默认延迟加载

然后在需要预加载books的查询中手动添加：

from sqlalchemy.orm import joinedload

# 需要预加载books时
session.query(Author).options(joinedload(Author.books))

# 需要关联Page时，直接手动JOIN，不会有重复
session.query(Author).outerjoin(Author.books, Page)

这种方式能避免默认预加载带来的意外JOIN，让查询逻辑更清晰。

以上三种方案在MySQL和SQLite中都能正常工作，因为SQLAlchemy的ORM层是跨数据库兼容的。

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