如何在SQLAlchemy中基于不同表的字段创建复合外键？

问题核心原因 #

SQL层面的外键约束要求本地表必须存储对应关联列的值，你当前的写法试图用关联表的列作为本地外键字段，不符合SQL标准，因此触发报错。

可行方案 #

方案1：仅在ORM层面做关联（不需要修改表结构，推荐）

直接删除Match类__table_args__中的所有ForeignKeyConstraint配置，通过自定义relationship的关联条件实现逻辑关联，不需要数据库层面的外键约束。
首先修正你代码里的笔误：Player类的__tablename__当前错误写成了tournament，需要改为player，否则会和赛事表冲突。
修改后的核心代码示例：

class Player(Base):
    __tablename__ = "player"
    __table_args__ = ({"schema": "test"})

    id_ = sa.Column(sa.Integer, primary_key=True)
    orig_id = sa.Column(sa.Integer)
    tour_id = sa.Column(sa.Integer)


class Tournament(Base):
    __tablename__ = "tournament"
    __table_args__ = ({"schema": "test"})

    id_ = sa.Column(sa.Integer, primary_key=True)
    orig_id = sa.Column(sa.Integer)
    tour_id = sa.Column(sa.Integer)

    match = relationship("Match", back_populates="tournament")


class Match(Base):
    __tablename__ = "match"
    __table_args__ = ({"schema": "test"},)

    id_ = sa.Column(sa.Integer, primary_key=True)
    tournament_orig_id = sa.Column(sa.Integer)
    round_id = sa.Column(sa.Integer)
    player_orig_id_p1 = sa.Column(sa.Integer)
    player_orig_id_p2 = sa.Column(sa.Integer)

    # 自定义赛事关联逻辑
    tournament = relationship(
        "Tournament",
        primaryjoin="and_(foreign(Match.tournament_orig_id) == Tournament.orig_id)",
        back_populates="match",
        uselist=False
    )

    # 自定义运动员关联逻辑，通过关联的tournament拿到tour_id
    player_p1 = relationship(
        "Player",
        primaryjoin="and_(foreign(Match.player_orig_id_p1) == Player.orig_id, Player.tour_id == Match.tournament.tour_id)",
        uselist=False
    )
    player_p2 = relationship(
        "Player",
        primaryjoin="and_(foreign(Match.player_orig_id_p2) == Player.orig_id, Player.tour_id == Match.tournament.tour_id)",
        uselist=False
    )

这个方案完全不需要修改表结构，不新增字段，所有关联逻辑都在ORM层面处理，不影响你直接执行API返回的SQL语句。

方案2：用数据库生成列实现数据库级外键约束（需要新增字段但无需手动维护）

如果你需要数据库层面的外键来保证数据一致性，可以在match表新增tour_id字段，设置为计算生成列，数据库会自动从关联的tournament表同步值，完全不需要你手动维护，也不存在“破坏规范化”的问题：

class Match(Base):
    __tablename__ = "match"
    __table_args__ = (
        sa.ForeignKeyConstraint(
            ["tournament_orig_id", "tour_id"],
            ["tournament.orig_id", "tournament.tour_id"],
            "fk_tournament",
        ),
        sa.ForeignKeyConstraint(
            ["player_orig_id_p1", "tour_id"],
            ["player.orig_id", "player.tour_id"],
            "fk_p1",
        ),
        sa.ForeignKeyConstraint(
            ["player_orig_id_p2", "tour_id"],
            ["player.orig_id", "player.tour_id"],
            "fk_p2",
        ),
        {"schema": "test"},
    )

    id_ = sa.Column(sa.Integer, primary_key=True)
    tournament_orig_id = sa.Column(sa.Integer)
    round_id = sa.Column(sa.Integer)
    player_orig_id_p1 = sa.Column(sa.Integer)
    player_orig_id_p2 = sa.Column(sa.Integer)
    # 生成列示例（PostgreSQL写法，不同数据库语法略有差异）
    tour_id = sa.Column(sa.Integer, sa.Computed("(SELECT t.tour_id FROM test.tournament t WHERE t.orig_id = tournament_orig_id)", persisted=True))

    tournament = relationship("Tournament", back_populates="match")

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