实例化SQLAlchemy声明式映射类时，缺失id和elements参数报错

问题原因 #

使用MappedAsDataclass时，SQLAlchemy会将所有Mapped类型的属性（包括主键id和一对多关系elements）自动生成dataclass的__init__参数，且默认是必填项。实例化时未传入这两个参数，因此触发TypeError。

解决方案 #

给不需要在实例化时传入的属性（主键、关系字段）添加init=False参数，将它们排除出dataclass的初始化参数列表。同时可给关系字段设置default_factory来初始化默认值。

修改后的完整代码示例 #

from sqlalchemy import Integer, String
from sqlalchemy.orm import (
    DeclarativeBase,
    MappedAsDataclass,
    mapped_column,
    relationship
)

# 基础类定义
class Base(MappedAsDataclass, DeclarativeBase):
    pass

# Company类（一对多的一方）
class Company(Base):
    __tablename__ = "companies"
    
    # 主键id：设置init=False，无需实例化时传入
    id: Mapped[int] = mapped_column(Integer, primary_key=True, init=False)
    name: Mapped[str] = mapped_column(String(50))
    url: Mapped[str] = mapped_column(String(100))
    stype: Mapped[str] = mapped_column(String(20))
    
    # 关系字段elements：设置init=False排除初始化参数，default_factory=list初始化空列表
    elements: Mapped[list["Element"]] = relationship(
        back_populates="company",
        init=False,
        default_factory=list
    )

# Element类（多对一的一方）
class Element(Base):
    __tablename__ = "elements"
    
    id: Mapped[int] = mapped_column(Integer, primary_key=True, init=False)
    name: Mapped[str] = mapped_column(String(50))
    company_id: Mapped[int] = mapped_column(Integer)
    
    # 反向关系：同样设置init=False
    company: Mapped["Company"] = relationship(back_populates="elements", init=False)

验证实例化 #

现在可以正常实例化Company，无需传入id和elements：

company = Company(name="示例公司", url="https://example.com", stype="互联网")

关键说明 #

• init=False：告诉SQLAlchemy不要将该属性加入dataclass的__init__参数列表，避免实例化时要求传入。
• default_factory=list：可选配置，确保elements属性在实例创建时自动初始化为空列表，后续操作时不会出现None相关的错误。
• 主键id作为自增字段，数据库会自动生成值，因此不需要手动传入，必须设置init=False。

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