SQLAlchemy多外键引用同表user.id列时的关系映射报错问题

User与Rating表之间存在两条外键关联路径：Rating.rater_id → User.id、Rating.ratee_id → User.id，SQLAlchemy无法自动匹配每个relationship对应的关联规则，因此抛出歧义错误。之前添加foreign_keys参数未生效，通常是参数指定位置错误、或指向了错误的列。

直接按照如下方式配置两个relationship，显式指定每个关系对应的外键列即可：

class Rating(db.Model):
  id = db.Column(db.Integer, primary_key=True)
  rater_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
  ratee_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)

class User(db.Model, UserMixin):
  id = db.Column(db.Integer, primary_key=True)
  username = db.Column(db.String(32), unique=True, nullable=False)
  # 「用户发出的评分」对应外键为rater_id
  ratesOfOthers = db.relationship(
    'Rating',
    foreign_keys='Rating.rater_id',
    backref='rater',
    lazy=True
  )
  # 「用户收到的评分」对应外键为ratee_id
  ratingsByOthers = db.relationship(
    'Rating',
    foreign_keys='Rating.ratee_id',
    backref='ratee',
    lazy=True
  )

• foreign_keys参数必须指向Rating表上的外键列，格式为类名.列名（类名首字母小写，对应SQLAlchemy默认的表名规则），也可以直接传入列对象：foreign_keys=[Rating.rater_id]，两种写法效果完全等价。
• 两个relationship必须分别显式指定对应外键，不能仅给其中一个添加参数，否则SQLAlchemy依然无法区分两条关联路径。

• 不要把foreign_keys参数写到backref的配置中，该参数是relationship本身的配置项，不属于反向引用的配置内容。
• 不要误写为foreign_keys='User.id'，该参数描述的是从子表指向父表的外键，而非父表的主键。
• 如果后续需要添加删除/更新级联规则，可直接在对应relationship的配置中添加cascade参数，无需额外调整外键指定规则。

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