SQLAlchemy 2.0.22：如何为automap模型添加hybrid properties？

直接监听automap基类的mapper_configured事件，而非子类。这样既不会提前触发报错，又能在子类mapper完成配置（列属性已生成）时执行逻辑添加hybrid property。

完整代码示例：

from sqlalchemy.ext.automap import automap_base
from sqlalchemy import create_engine
from sqlalchemy import event
from sqlalchemy.ext.hybrid import hybrid_property

# 创建automap基类
AutoMapped = automap_base()

# 定义自定义子类，必须指定对应数据库表名
class MyModel(AutoMapped):
    __tablename__ = 'my_table'

# 监听基类的mapper_configured事件
@event.listens_for(AutoMapped, 'mapper_configured')
def add_hashed_pseudo_columns(mapper, model):
    # 仅针对目标子类执行逻辑
    if model is MyModel:
        print("mapper_configured for MyModel")
        
        # 添加hybrid property，可直接引用automap生成的列属性
        @hybrid_property
        def full_name(self):
            return f"{self.first_name} {self.last_name}"
        
        # 将hybrid property绑定到模型类
        setattr(model, 'full_name', full_name)

# 初始化引擎并执行prepare
engine = create_engine('sqlite:///your_db.db')
AutoMapped.prepare(autoload_with=engine)

核心逻辑说明 #

• 监听基类AutoMapped的mapper_configured事件，SQLAlchemy会在每个子类的mapper完成配置时触发回调，此时automap已经生成了所有列属性，可安全引用。
• 事件注册在prepare()调用之前，不会触发UnmappedClassError——因为基类本身是可监听对象，无需提前完成映射。
• 通过if model is MyModel:过滤，可精准给目标子类添加属性，不会影响automap自动生成的其他模型。

若需给多个automap子类添加属性，只需在回调中扩展判断逻辑即可。

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