SQLAlchemy问题：OuterJoin中Add_*不生效别名+关联查询过滤异常

听起来你遇到的是SQLAlchemy里全局过滤活跃数据时，左连接场景下主表数据被意外过滤的典型问题，还要适配通用查询函数、处理别名的问题——我来给你捋几个靠谱的解决方案：

首选方案：用with_loader_criteria实现全局自动过滤（SQLAlchemy 1.4+） #

这是SQLAlchemy官方推荐的全局过滤方案，完美解决你提到的所有痛点：

1. 全局注册过滤规则 #

假设你的所有模型都继承自一个带is_active字段的基类，只需要注册一个会话事件，就能让所有查询自动应用活跃过滤：

from sqlalchemy import event
from sqlalchemy.orm import Session
from your_project.models import Base  # 你的模型基类

@event.listens_for(Session, "do_orm_execute")
def apply_global_active_filter(execute_state):
    # 只对SELECT查询生效
    if execute_state.is_select:
        # include_aliases=True 解决OuterJoin的别名问题
        execute_state.statement = execute_state.statement.options(
            with_loader_criteria(
                Base, 
                lambda cls: cls.is_active == True, 
                include_aliases=True
            )
        )

2. 为什么这能解决你的问题？ #

• 左连接不丢失主表数据：它会把过滤条件加到JOIN子句里（而不是WHERE），比如左连接关联表时，会变成LEFT JOIN assoc_table ON ... AND assoc_table.is_active = true，这样主表的所有数据都会保留，关联表只返回活跃的记录（没有关联的话就是NULL）。
• 通用函数无需修改：这个规则是全局生效的，不管你用什么通用查询函数，只要查询涉及到继承自Base的模型，过滤条件会自动加上。
• 别名自动适配：include_aliases=True参数会让过滤规则应用到该模型的所有别名（不管是你显式定义的aliased()，还是SQLAlchemy自动生成的），完美解决OuterJoin别名不生效的问题。

备选方案：自定义查询类（兼容旧版本SQLAlchemy） #

如果你还在使用SQLAlchemy 1.3及以下版本，可以自定义查询类来封装全局过滤逻辑：

from sqlalchemy.orm import Query

class ActiveFilterQuery(Query):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 给主实体添加活跃过滤
        for entity in self._entities:
            if hasattr(entity.entity, 'is_active'):
                self = self.filter(entity.entity.is_active == True)
        
        # 给左连接的关联表添加JOIN级过滤
        def _enhance_join_condition(join):
            if hasattr(join.right, 'is_active'):
                return join.onclause & (join.right.is_active == True)
            return join.onclause
        
        self._join_conditions = [_enhance_join_condition(j) for j in self._join_conditions]

# 创建会话时指定自定义查询类
from sqlalchemy.orm import sessionmaker
Session = sessionmaker(bind=your_engine, query_cls=ActiveFilterQuery)

这个方案需要自己处理更多细节，但核心逻辑和with_loader_criteria一致——把过滤放到JOIN环节，避免过滤主表数据。

为什么不推荐在relationship里加过滤？ #

你提到不想在关联模型的relationship里加filter，这个判断很对：这种方式是局部生效的，只有通过该relationship加载关联数据时才会过滤，直接查询关联模型或者其他relationship时就失效了，完全达不到全局过滤的目的。

总结 #

如果你用的是SQLAlchemy 1.4+，直接用with_loader_criteria是最优解，一步解决全局过滤、左连接保留主表、别名适配的所有问题，完全不需要改动你的通用查询函数。

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