SQLAlchemy hybrid_property初始化无法设置，提示无效关键字参数？

模型代码： #

from sqlalchemy.ext.hybrid import hybrid_property

class Connection(Model):
    name = db.Column(db.String, nullable=False)  # 修正原代码的`dbColumn`拼写错误
    provider = db.Column(db.String, nullable=True)
    version = db.Column(db.Integer, nullable=True)
    _connection_status = db.Column('connection_status', db.String, nullable=True)

    @hybrid_property
    def connection_status(self) -> str:
        if not self._connection_status:
            self._connection_status = "Connection_Not_Set"
        return self._connection_status  # 修正原代码的`return self._status`错误

    @connection_status.setter
    def connection_status(self, connection_status: str):
        self._connection_status = connection_status

问题现象： #

• 直接在初始化时传入connection_status参数会报错：

  # 报错：'connection_status' is an invalid keyword argument
  connection = Connection(name="Connection1", connection_status="Initialized")
  

• 先创建对象再赋值则正常：

  # 无报错
  connection = Connection(name="Connection1")
  connection.connection_status = "Initialized"
  

原因解析： #

SQLAlchemy模型的构造函数（__init__）默认只处理被ORM映射到数据库列的属性——也就是直接用db.Column定义的字段（比如name、provider、_connection_status）。而hybrid_property是Python层面的属性封装，本质是通过getter/setter方法操作底层的_connection_status字段，它不属于ORM的映射列集合，因此初始化时无法被识别为合法的关键字参数。

解决办法： #

1. 保持先创建再赋值的方式：这是最简单直接的方案，符合现有代码逻辑。
2. 自定义模型的__init__方法：手动处理connection_status参数，示例如下：

   class Connection(Model):
       # （原有列定义和hybrid_property代码不变）
       
       def __init__(self, **kwargs):
           # 先取出connection_status参数（如果存在）
           status = kwargs.pop('connection_status', None)
           # 调用父类初始化方法处理其他ORM字段
           super().__init__(**kwargs)
           # 如果传入了status，再赋值给hybrid_property
           if status is not None:
               self.connection_status = status
   

   这样就可以直接用Connection(name="Connection1", connection_status="Initialized")初始化对象了。

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