如何为SQLModel模型定义可复用的类方法形式通用WHERE子句，同时保留别名（aliased）功能？

你遇到的问题本质是Python类方法的绑定机制和SQLModel/SQLAlchemy别名对象的代理特性冲突导致的：类方法的cls参数永远指向原模型类，而不是调用它的别名代理对象。要保留类方法式的复用性同时支持别名，我们可以用Python描述符来替代类方法，或者用SQLAlchemy的hybrid_method扩展，下面是两种具体的解决方案：

方案一：使用Python描述符（推荐，不依赖额外扩展） #

描述符可以拦截属性访问，根据访问的对象（原模型类或别名代理）动态生成对应条件，既保留了继承复用的特性，又能正确适配别名。

步骤1：定义通用条件描述符 #

首先封装一个通用的描述符类，用来处理条件的动态生成：

from typing import Callable, TypeVar
from sqlmodel import SQLModel

# 泛型适配任意SQLModel子类
T = TypeVar("T", bound=SQLModel)

class QueryConditionDescriptor:
    def __init__(self, condition_func: Callable[[T], any]):
        self.condition_func = condition_func

    def __get__(self, instance: T | None, owner: type[T]) -> any:
        # 动态判断目标：从类访问用原模型，从别名对象访问用代理
        target = instance or owner
        return self.condition_func(target)

步骤2：在父类中封装通用条件 #

用描述符替代类方法定义通用的查询条件，子类继承后可直接使用：

from datetime import datetime
from sqlmodel import Field, DateTime

class SoftDeletable(SQLModel):
    deletedAt: datetime | None = Field(default=None, nullable=True)

    @staticmethod
    def _get_deleted_condition(target: "SoftDeletable"):
        return target.deletedAt.is_not(None)

    # 用描述符封装，提供简洁的访问语法
    deleted = QueryConditionDescriptor(_get_deleted_condition)

# 子类继承后自动获得通用条件
class Person(SQLModel, SoftDeletable, table=True):
    id: int | None = Field(default=None, primary_key=True)
    name: str

步骤3：原模型和别名对象的统一使用 #

不管是直接用原模型还是别名代理，都能正确生成对应表/别名的条件：

from sqlmodel import select, aliased

# 原模型场景
query = select(Person).where(Person.deleted)

# 别名代理场景（子查询关联）
some_sub_query = select(Person).where(Person.name.like("A%")).subquery()
aliased_person = aliased(Person, some_sub_query)
query = select(Person).join(some_sub_query).where(aliased_person.deleted)

方案优势

• 完全保留父类复用特性：子类继承后自动获得通用条件，无需重复代码
• 支持扩展：子类可以重写_get_deleted_condition来自定义逻辑
• 纯Python实现，不依赖SQLAlchemy额外扩展

方案二：使用SQLAlchemy的hybrid_method扩展 #

如果你的项目已经依赖SQLAlchemy的hybrid扩展，也可以用hybrid_method实现，它能同时支持**实例级别（已查询对象的判断）和类/别名级别（查询构造）**的逻辑：

from sqlalchemy.ext.hybrid import hybrid_method
from sqlmodel import SQLModel, Field, DateTime
from datetime import datetime

class SoftDeletable(SQLModel):
    deletedAt: datetime | None = Field(default=None, nullable=True)

    @hybrid_method
    def deleted(self) -> bool:
        # 实例级别逻辑：判断已加载的对象是否被软删除
        return self.deletedAt is not None

    @deleted.expression
    def deleted(cls) -> any:
        # 类/别名级别逻辑：构造查询条件
        return cls.deletedAt.is_not(None)

class Person(SQLModel, SoftDeletable, table=True):
    id: int | None = Field(default=None, primary_key=True)
    name: str

使用方式 #

调用语法和类方法完全一致，别名对象会自动适配：

aliased_person = aliased(Person, some_sub_query)
query = select(Person).join(some_sub_query).where(aliased_person.deleted())

方案优势

• 同时支持实例判断和查询构造，适合业务代码中同时处理已加载对象和查询的场景
• 语法和原类方法几乎一致，学习成本低

备注：内容来源于stack exchange，提问作者L. Gig