SQLAlchemy hybrid_property初始化报错：'decimals'为无效关键字参数

解决方案：重写类的构造函数，手动处理decimals参数 #

SQLAlchemy的默认声明式构造函数只会处理映射的数据库字段（如Column定义的属性），不会自动识别hybrid_property作为构造参数。你可以通过重写__init__方法绕过这个限制：

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import Column, Integer, String
from decimal import Decimal

Base = declarative_base()

class Test_Db(Base):
    __tablename__ = "test_db"
    
    id = Column(Integer, primary_key=True)
    _decimals = Column(String)  # 数据库中存储的字符串字段

    @hybrid_property
    def decimals(self) -> list[Decimal]:
        if not self._decimals:
            return []
        return [Decimal(dec) for dec in self._decimals.replace('d', '').split(';')]

    @decimals.setter
    def decimals(self, decimals):
        if not decimals:
            self._decimals = ""
        else:
            self._decimals = ';'.join(str(dec) for dec in decimals)

    def __init__(self, **kwargs):
        # 从参数中取出decimals，剩下的交给父类构造处理
        decimals_val = kwargs.pop("decimals", None)
        super().__init__(**kwargs)
        # 如果传入了decimals，调用setter设置值
        if decimals_val is not None:
            self.decimals = decimals_val

现在你可以正常用decimals参数初始化实例：

test_instance = Test_Db(decimals=[Decimal("1.23"), Decimal("4.56")])

原因分析 #

你遇到的错误来自SQLAlchemy的_declarative_constructor方法，它会校验所有传入的关键字参数是否属于类的映射属性（即数据库列或关系）。虽然hybrid_property是类属性，但它不属于映射属性范畴，因此会被构造函数判定为无效参数。

通过重写__init__，我们先手动提取decimals参数，让父类构造函数处理其他合法的映射属性，之后再通过hybrid_property的setter给实例赋值，完美避开了构造函数的参数校验逻辑。

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