如何在SQLAlchemy子查询中使用joinedload？Flask多对多场景

你遇到的核心问题是**joinedload是ORM级别的预加载策略，并非SQL层面的JOIN操作**。它的作用是告诉SQLAlchemy在加载主模型时顺便加载关联数据，但不会修改主查询的SELECT列表和JOIN结构——关联数据要么通过额外查询获取，要么在ORM结果处理阶段匹配。所以当你调用.subquery()时，子查询只会包含主表artists的字段，自然找不到artwork_id。

方案1：用SQL JOIN替代joinedload（推荐） #

直接通过SQL层面的JOIN关联表，这样关联字段会被包含在查询中，转成子查询后就能正常访问：

from sqlalchemy import func

columns = ['artist_id', 'artist_name']
join_columns = ['artwork_id']

# 直接JOIN关联表，替代joinedload
subq = (
    db.session.query(
        Artists.artist_id,
        Artists.artist_name,
        Artworks.artwork_id
    )
    .join(Artists.artworks_rel, isouter=True)  # 左连接保留无作品的艺术家
    .filter(Artists.artist_id == "my_id")
    .subquery()
)

# 基于子查询做聚合
query = (
    db.session.query(
        subq.c.artist_id,
        func.string_agg(subq.c.artwork_id, ',')
    )
    .select_from(subq)
    .group_by(subq.c.artist_id)
)

方案2：跳过子查询，直接完成聚合 #

不需要子查询，直接在主查询中关联并聚合，代码更简洁：

from sqlalchemy import func

query = (
    db.session.query(
        Artists.artist_id,
        Artists.artist_name,
        func.string_agg(Artworks.artwork_id, ',')
    )
    .join(Artists.artworks_rel, isouter=True)
    .filter(Artists.artist_id == "my_id")
    .group_by(Artists.artist_id, Artists.artist_name)
)

方案3：使用subqueryload（适配ORM预加载+子查询场景） #

如果你确实需要保留ORM模型的加载逻辑，同时生成包含关联数据的子查询，可以用subqueryload替代joinedload，但要注意显式选择关联字段：

from sqlalchemy.orm import subqueryload

subq = (
    db.session.query(
        Artists.artist_id,
        Artists.artist_name,
        Artworks.artwork_id
    )
    .options(subqueryload(Artists.artworks_rel).load_only(*join_columns))
    .join(Artists.artworks_rel, isouter=True)
    .filter(Artists.artist_id == "my_id")
    .subquery()
)

• joinedload适合在需要加载ORM关联对象，但不需要在SQL查询中直接使用关联字段的场景（比如后续在Python代码中访问artist.artworks_rel）。
• 当需要在SQL层面操作关联字段（比如聚合、过滤）时，必须使用SQL JOIN显式关联表，而非ORM预加载策略。

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