如何查询全部Parent对象并过滤子列表但不排除父对象

问题根源 #

你原来的代码把Child.a == None放在主查询的filter中，导致outerjoin后，那些没有符合条件子对象的Parent虽然会被匹配到（因为Child字段全为NULL，Child.a IS NULL成立），但contains_eager会把这个NULL的Child加载到父对象的子列表里，出现不符合预期的[None]；同时如果Parent有子对象但都不符合条件，也会因为同样的问题导致子列表异常。

方案一：带过滤条件的contains_eager（推荐） #

SQLAlchemy 1.4及以上版本支持直接在contains_eager中添加子对象过滤条件，无需额外join，就能自动加载所有Parent，且仅保留符合条件的子对象，无符合条件时子列表为空：

from sqlalchemy import select, contains_eager

stmt = select(Parent).options(
    contains_eager(Parent.child).filter(Child.a == None)
)
parents = session.scalars(stmt).all()

方案二：调整Outer Join的关联条件 #

如果需要用join方式实现，把过滤条件放到outerjoin的on子句中，而非主查询的filter，避免过滤Parent，同时只关联符合条件的子对象：

from sqlalchemy import select, and_

stmt = select(Parent).outerjoin(
    Parent.child,
    and_(Parent.id == Child.parent_id, Child.a == None)
).options(contains_eager(Parent.child))
parents = session.scalars(stmt).unique().all()

这里的unique()是为了合并同一Parent的多行结果（当一个Parent有多个符合条件的子对象时），确保每个Parent只返回一次，子列表包含所有符合条件的子对象。

方案三：Subquery替代方案 #

也可以通过子查询预先筛选符合条件的子对象，再关联到Parent，本质和方案二逻辑一致：

from sqlalchemy import select, and_

# outerjoin关联符合条件的Child
stmt = select(Parent).outerjoin(
    Parent.child,
    and_(Parent.id == Child.parent_id, Child.a == None)
).options(contains_eager(Parent.child))
parents = session.scalars(stmt).unique().all()

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