SQLAlchemy中User模型间关注关系配置失败问题排查

你的Follow和User模型关联配置存在几个关键问题，导致无法正常工作，下面逐一说明并给出修复代码：

1. Follow模型未明确关联对应的外键 #

Follow表有两个指向User的外键（follower和followed），但你定义的两个relationship没有指定foreign_keys参数，SQLAlchemy无法区分每个关联对应哪个外键，会引发关联混淆或报错。

2. User模型缺少反向关联 #

目前只定义了followers（关注当前用户的粉丝记录），但没有定义following（当前用户主动关注的记录），无法完整实现双向的关注关系查询。

3. 关联的back_populates对应关系错误 #

当前User的followers关联的是Follow的followeruser，但逻辑上followers应该是所有关注当前用户的Follow记录（即Follow中followed字段等于当前用户id的记录），所以应该对应Follow的followeduser。

修正后的代码 #

Follow模型 #

class Follow(SqlAlchemyBase):
    __tablename__ = 'followers'

    followid = sqlalchemy.Column(sqlalchemy.Integer, primary_key=True)
    follower = sqlalchemy.Column(sqlalchemy.Integer, sqlalchemy.ForeignKey('users.id'), nullable=False)
    followed = sqlalchemy.Column(sqlalchemy.Integer, sqlalchemy.ForeignKey('users.id'), nullable=False)

    # 关联发起关注的用户（粉丝），明确对应外键follower
    followeruser = orm.relationship("User", foreign_keys=[follower], back_populates='following')
    # 关联被关注的用户，明确对应外键followed
    followeduser = orm.relationship("User", foreign_keys=[followed], back_populates='followers')

User模型 #

class User(SqlAlchemyBase, UserMixin, SerializerMixin):
    __tablename__ = 'users'

    id = sqlalchemy.Column(sqlalchemy.Integer, primary_key=True, autoincrement=True)
    name = sqlalchemy.Column(sqlalchemy.String, nullable=True)
    age = sqlalchemy.Column(sqlalchemy.Integer, nullable=True)
    about = sqlalchemy.Column(sqlalchemy.String, nullable=True, default='Не важно')
    email = sqlalchemy.Column(sqlalchemy.String, index=True, unique=True, nullable=True)
    avatar = sqlalchemy.Column(sqlalchemy.String, default='images/default/avatar.jpg')
    hashed_password = sqlalchemy.Column(sqlalchemy.String, nullable=True)
    modified_date = sqlalchemy.Column(sqlalchemy.DateTime, default=datetime.datetime.now)
    # 建议将is_private改为Boolean类型，更符合逻辑与数据库规范
    is_private = sqlalchemy.Column(sqlalchemy.Boolean, default=False)
    quezes = orm.relationship("Quezes", back_populates='author')

    # 所有关注当前用户的粉丝记录，对应Follow的followeduser
    followers = orm.relationship("Follow", back_populates='followeduser')
    # 当前用户主动关注的所有记录，对应Follow的followeruser
    following = orm.relationship("Follow", back_populates='followeruser')

使用示例 #

# 创建两个测试用户
user1 = User(name="张三")
user2 = User(name="李四")
db_session.add_all([user1, user2])
db_session.commit()

# 张三关注李四
follow_relation = Follow(follower=user1.id, followed=user2.id)
db_session.add(follow_relation)
db_session.commit()

# 查询李四的所有粉丝（预期输出：['张三']）
print([f.followeruser.name for f in user2.followers])

# 查询张三关注的所有人（预期输出：['李四']）
print([f.followeduser.name for f in user1.following])

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