SQLAlchemy 2.0如何正确配置自引用外键？异步引擎问题排查

我使用SQLAlchemy异步引擎开发，模型代码如下：

class MyModel(Base):
    __tablename__ = 'model'

    id          : Mapped[int]       = mapped_column(primary_key=True)
    given_id    : Mapped[str]       = mapped_column(String(50), unique=True, nullable=True)
    cancel_id   : Mapped[int]       = mapped_column(ForeignKey('model.given_id'), nullable=True)
    return_model: Mapped['MyModel'] = relationship(remote_side=[given_id])

调用return_model时触发错误：

sqlalchemy.exc.MissingGreenlet: greenlet_spawn has not been called; can't call await_only() here. Was IO attempted in an unexpected place?

但把代码里的given_id替换成id后，自引用就能正常工作：

class MyModel(Base):
    __tablename__ = 'model'

    id          : Mapped[int]       = mapped_column(primary_key=True)
    given_id    : Mapped[str]       = mapped_column(String(50), unique=True, nullable=True)
    cancel_id   : Mapped[int]       = mapped_column(ForeignKey('model.id'), nullable=True)
    return_model: Mapped['MyModel'] = relationship(remote_side=[id])

请问：

1. SQLAlchemy 2.0中正确的自引用方式是什么？
2. 如何实现一对一自引用关系？
3. 我之前的代码哪里出错了？

错误原因 #

核心问题是外键字段与被关联字段类型不匹配：

• given_id是String(50)类型，但你定义的cancel_id是int类型，类型不匹配导致SQLAlchemy异步加载关联对象时内部逻辑异常，触发MissingGreenlet错误。
• 换成关联主键id后，cancel_id的int类型与id的int类型匹配，加载逻辑恢复正常。

正确的自引用方式 #

自引用的关键是保证外键字段类型与被关联字段完全一致，同时通过remote_side参数指定关系的反向端字段，步骤如下：

1. 定义被关联字段（可以是主键，也可以是带唯一约束的普通字段）
2. 定义外键字段，其数据类型必须和被关联字段完全相同
3. 通过relationship建立关联，用remote_side指定被关联的字段

一对一自引用的实现 #

要实现一对一关系，需在relationship中添加uselist=False参数（默认是一对多，uselist=True），同时确保被关联字段带有唯一约束（保证关联对象唯一）。

基于given_id的一对一自引用代码示例 #

class MyModel(Base):
    __tablename__ = 'model'

    id          : Mapped[int]       = mapped_column(primary_key=True)
    given_id    : Mapped[str]       = mapped_column(String(50), unique=True, nullable=True)
    # 修正cancel_id类型为String，与given_id匹配
    cancel_id   : Mapped[str]       = mapped_column(ForeignKey('model.given_id'), nullable=True)
    # 添加uselist=False实现一对一，remote_side指定被关联的given_id
    return_model: Mapped['MyModel'] = relationship(remote_side=[given_id], uselist=False)

基于主键的一对一自引用示例（更常用场景） #

class MyModel(Base):
    __tablename__ = 'model'

    id          : Mapped[int]       = mapped_column(primary_key=True)
    given_id    : Mapped[str]       = mapped_column(String(50), unique=True, nullable=True)
    cancel_id   : Mapped[int]       = mapped_column(ForeignKey('model.id'), nullable=True)
    return_model: Mapped['MyModel'] = relationship(remote_side=[id], uselist=False)

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