Flask SQLAlchemy同表自引用一对多关系配置报错排查

错误原因 #

两次报错均为参数配置错误导致：

1. 首次抛出AmbiguousForeignKeysError：Dog表存在两个指向自身主键的外键列（father_id、mother_id），SQLAlchemy无法自动匹配两个关系分别对应的外键路径
2. 第二次抛出NoForeignKeysError：给foreign_keys参数传入了主键列[id]，未指定实际用于关联的外键字段，框架无法生成表连接条件

正确实现代码 #

注意外键列需要定义在relationship之前，避免引用时找不到字段：

class Dog(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    birthday = db.Column(db.DateTime, index=True)
    sex = db.Column(db.String(64))
    comments = db.Column(db.String(1000))

    # 先定义外键列
    father_id = db.Column(db.Integer, db.ForeignKey('dog.id'))
    mother_id = db.Column(db.Integer, db.ForeignKey('dog.id'))

    # 父亲关联的所有子代：通过子代的father_id关联
    fathered = db.relationship(
        "Dog",
        backref=db.backref("father", remote_side=[id]),
        foreign_keys=[father_id]
    )
    # 母亲关联的所有子代：通过子代的mother_id关联
    mothered = db.relationship(
        "Dog",
        backref=db.backref("mother", remote_side=[id]),
        foreign_keys=[mother_id]
    )

使用说明 #

• 查子代：访问公犬实例的fathered属性，即可获取该犬作为父亲的所有后代；访问母犬实例的mothered属性，即可获取该犬作为母亲的所有后代
• 查父母：访问任意犬只实例的father/mother属性，即可直接获取对应的父亲、母亲实例，无需额外编写查询语句
• 如果需要获取某只犬不区分父母方的所有子代，可以额外编写类属性，用or_条件合并fathered和mothered的结果即可，常规直系亲属查询场景上述配置已经完全覆盖。

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