Graphene结合SQLAlchemy触发AssertionError：需传入有效SQLAlchemy模型

问题根因 #

你遇到的报错本质是User模型没有被SQLAlchemy正确完成ORM映射，graphene-sqlalchemy校验时无法识别为合法模型，具体触发点有3个： #

1. 关联表的字段定义错误 #

你在AnnouncementsSeen、CompletedCourses、CompletedChapters三个关联表中，直接把外键字段定义为了relationship类型，正确的写法应该是：先定义Column类型的外键存储字段，再单独定义关联关系。同时三个关系的backref都命名为user，触发SQLAlchemy映射冲突，直接导致映射失败。

2. 枚举字段默认值类型错误 #

User类的membership_status是Enum类型，你直接传入了字符串'SU'作为默认值，需要传入对应的枚举成员。

3. 可选：版本兼容性问题 #

如果你使用的是SQLAlchemy 2.0+版本，低于3.0b1的graphene-sqlalchemy不支持新的映射逻辑，也会触发该报错。 #

修复方案 #

第一步：修正关联表的字段和关系 #

# 修正AnnouncementsSeen表
class AnnouncementsSeen(Base):
    __tablename__ = 'announcements_seen'
    id = Column(Integer, primary_key=True)
    # 先定义外键存储字段
    user_id = Column(Integer, ForeignKey('user.id'), index=True)
    announcement_id = Column(ForeignKey('announcement.id'), index=True)

# 修正CompletedCourses表
class CompletedCourses(Base):
    __tablename__ = 'completed_courses'
    id = Column(Integer, primary_key=True)
    participant_id = Column(Integer, ForeignKey('user.id'), index=True)
    course_id = Column(ForeignKey('course.id'), index=True)

# 修正CompletedChapters表
class CompletedChapters(Base):
    __tablename__ = 'completed_chapters'
    id = Column(Integer, primary_key=True)
    participant_id = Column(Integer, ForeignKey('user.id'), index=True)
    chapter_id = Column(ForeignKey('chapter.id'), index=True)
    course_id = Column(ForeignKey('course.id'))
    status = Column(Enum(CourseStatusChoice))
    scored_points = Column(Integer, default=0)
    total_points = Column(Integer, default=0)
    percentage = Column(Integer, default=0)

# 修正User类的关系定义，backref不要重名
class User(Base):
    __tablename__ = "user"
    # 原有字段不变
    # 修正枚举默认值
    membership_status = Column(Enum(MembershipStatusChoice), nullable=False, default=MembershipStatusChoice.SU)
    # 修正关系的backref，避免重名
    chapters = relationship('CompletedChapters', backref='participant')
    courses = relationship('CompletedCourses', backref='participant')
    announcements = relationship("AnnouncementsSeen", backref='user')
    # 其余字段不变

第二步：检查版本兼容 #

如果使用SQLAlchemy 2.0+，执行以下命令升级graphene-sqlalchemy：

pip install graphene-sqlalchemy==3.0.0b3

第三步：预校验映射是否正常 #

改完代码后先单独测试模型映射，不要直接启动GraphQL服务，运行以下测试代码就能看到SQLAlchemy抛出的具体错误，解决完所有映射错误后再启动服务即可：

from database import Base, engine
from models import User

# 测试映射是否正常
Base.metadata.create_all(bind=engine)
print("SQLAlchemy映射成功")

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