如何在SQLAlchemy查询中过滤预加载的关联User实体？

问题出在你用了内连接（join），内连接会自动过滤掉没有匹配关联数据的主表记录。要实现“保留Company，仅过滤其关联的User”的需求，需要改用左外连接（outerjoin），并在关联加载的contains_eager中添加过滤条件，而不是直接在查询末尾加filter。

修改后的完整代码如下：

async def get_company_by_id(self, company_id: int, phone_filter: str) -> Company:
        logger.debug(f"Received data: {get_args()}")

        query = (
            select(Company)
            # 改用outerjoin，确保即使无匹配User也能返回Company
            .outerjoin(Company.users)
            .outerjoin(CompanyUser.users)
            .options(
                contains_eager(Company.users)
                .contains_eager(CompanyUser.users)
                # 在关联加载路径上添加User的过滤条件，仅过滤关联的User集合
                .filter(User.phone_number.like(phone_filter))
            )
            .where(Company.id == company_id)
        )
        result: Company = await self.get_instance(query)

        # 确保users列表为空而非None（如果ORM未自动处理）
        if result and not hasattr(result, 'users'):
            result.users = []
        elif result:
            logger.debug(f'Retrieved company by id "{company_id}":"{result}"')
        return result

关键修改点说明： #

• 替换join为outerjoin：左外连接会保留所有符合where条件的Company记录，不管有没有匹配的User。
• 在contains_eager路径中添加filter：这个过滤是针对关联的User实体的，只会筛选出符合手机号条件的User，不会影响Company本身的查询结果。
• 兜底处理空列表：如果ORM没有自动将空关联转为空列表，手动赋值避免返回None。

这样修改后，当有匹配手机号的User时，Company的users列表会包含这些User；无匹配时，Company的users列表为空数组，而不是返回None。

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