如何让SQLAlchemy可选关联返回默认对象而非None？

现有users和roles表，User可选择关联单个Role，原模型定义如下：

class User(Base):
    id: Mapped[int] = mapped_column(primary_key=True)

    role: Mapped[Optional["Role"]] = relationship(back_populates="user")
    # ...


class Role(Base):
    id: Mapped[int] = mapped_column(primary_key=True)
    user_id: Mapped[int] = mapped_column(ForeignKey("user.id"))

    user: Mapped[Optional["User"]] = relationship(back_populates="role")
    # ...

需求：让User.role始终返回一个Role对象，若User未关联Role，则返回新的默认实例Role()。希望直接覆盖默认属性名role的行为，而非新增方法（如直观方案中的role_or_new）。

类似方案的差异说明 #

• 通过SQLAlchemy事件设置关联默认值：逻辑复杂，且仅在持久化阶段生效，无法保证内存中访问role时始终返回实例。
• 新增方法替代原属性：需要修改所有调用role的业务代码，不符合“保留原属性名”的需求。
• 基于现有关联生成默认值：核心需求与本问题不同，本问题需要返回全新的默认实例，而非基于已有关联数据生成。

解决方案 #

将原关联属性重命名为内部属性，通过@property装饰器覆盖role的getter逻辑，同时保留setter以支持正常赋值：

class User(Base):
    id: Mapped[int] = mapped_column(primary_key=True)

    # 原关联属性改为内部存储，命名为_role
    _role: Mapped[Optional["Role"]] = relationship(back_populates="user")

    @property
    def role(self) -> "Role":
        # 无关联时返回新的Role实例
        return self._role or Role()

    @role.setter
    def role(self, value: Optional["Role"]) -> None:
        # 保留原赋值逻辑，允许传入None或Role实例
        self._role = value


class Role(Base):
    id: Mapped[int] = mapped_column(primary_key=True)
    user_id: Mapped[int] = mapped_column(ForeignKey("user.id"))

    # 反向关联指向User的内部属性_role
    user: Mapped[Optional["User"]] = relationship(back_populates="_role")
    # ...

方案说明 #

1. 属性覆盖逻辑：通过将原role关联重命名为_role，用@property定义的role完全替代原属性的访问行为，外部代码无需修改，依然使用user.role即可。
2. 持久化兼容性：设置user.role = None时，内部_role会被设为None，不会影响数据库中关联关系的移除；返回的默认Role()实例不会自动保存到数据库，若需要持久化该角色，需手动调用session.add(user.role)并提交。
3. 反向关联适配：Role中的back_populates需对应改为_role，确保SQLAlchemy的双向关联逻辑正常运行。

内容的提问来源于Stack Exchange，提问作者Roberto