FastAPI+SQLAlchemy异步查询报错：ObjectAssociationProxyInstance不可哈希

你遇到的TypeError: unhashable type: 'ObjectAssociationProxyInstance'，核心原因是你传入selectinload的Task.comments是关联代理（ObjectAssociationProxyInstance），而不是SQLAlchemy的真实ORM关系属性。

selectinload这类预加载方法只能接受由relationship()定义的关系属性，无法识别association_proxy生成的代理对象。

修正方案 #

1. 找到Task模型中对应通用关联的真实关系属性：通常在通用关联表的设计中，你会先定义一个中间关联的relationship（比如命名为comment_assocs），再通过association_proxy包装成comments方便直接访问。
2. 用真实关系属性做预加载，而非关联代理。

代码示例 #

假设你的模型定义大致如下：

# 通用关联表
comment_association = Table(
    "comment_association",
    Base.metadata,
    Column("comment_id", Integer, ForeignKey("comments.id"), primary_key=True),
    Column("object_id", Integer, primary_key=True),
    Column("object_type", String(50), primary_key=True),
)

class Comment(Base):
    __tablename__ = "comments"
    id = Column(Integer, primary_key=True)
    content = Column(Text)
    objects = relationship(
        "Task",
        secondary=comment_association,
        backref="comment_assocs"
    )

class Task(Base):
    __tablename__ = "tasks"
    id = Column(Integer, primary_key=True)
    title = Column(String(100))
    # 真实ORM关系：关联到Comment的中间关系
    comment_assocs = relationship("Comment", secondary=comment_association)
    # 关联代理：简化访问
    comments = association_proxy("comment_assocs", "content")

修正后的查询代码：

from sqlalchemy.orm import selectinload

# 用真实关系comment_assocs做预加载
query = select(models.Task).where(models.Task.id == id).options(selectinload(Task.comment_assocs))
result = await db.execute(query)
task = result.scalar_one()

# 此时task.comments可以正常访问，关联代理会自动从预加载的comment_assocs中取数据
print(task.comments)

如果你的关联层级更复杂（比如中间表是独立模型而非纯关联表），需要链式预加载深层关系：

# 假设CommentAssociation是独立模型，关联Task和Comment
query = select(models.Task).where(models.Task.id == id).options(
    selectinload(Task.comment_assocs).selectinload(CommentAssociation.comment)
)

关键说明 #

• 关联代理（association_proxy）只是简化数据访问的语法糖，底层依赖真实的ORM关系。
• 预加载必须针对真实关系操作，关联代理会自动利用预加载的数据，无需额外处理。

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