SQLAlchemy配置Users与Roles多对多关联时报NoForeignKeysError如何解决

触发当前NoForeignKeysError的核心是代码存在3处与SQLAlchemy外键识别规则不匹配的硬伤，并非多对多关系映射逻辑本身的问题：

• 外键引用的表名与物理表名不匹配
  SQLAlchemy的ForeignKey()参数中传入的字符串，匹配的是类属性__tablename__定义的数据库物理表名，而非映射类的类名。你在中间表中写的ForeignKey("Users.id")、ForeignKey("Roles.id")，对应的实际物理表名是你定义的小写users、roles，全局不存在名为Users、Roles的物理表，导致框架完全识别不到外键关联。
• 中间表缺失schema配置
  你的两张业务表都通过__table_args__指定了flaskProject schema，但关联中间表user_role没有配置相同的schema，即使表名修正，跨schema的表关联也无法被框架自动匹配外键关系。
• 表定义顺序的隐性放大效应
  你将中间表user_role放在两个业务表类之前定义，虽然框架支持字符串形式的延迟解析，但配合前面的表名、schema不匹配问题，会直接触发外键检测失败。

• 调整中间表的外键引用值，替换为实际物理表名
• 给中间表补充和业务表一致的schema配置
• （可选优化）将中间表的定义移到两个业务表类之后，减少不必要的延迟解析
• 如果因为代码结构限制无法调整定义顺序，可以在relationship()中手动补充primaryjoin、secondaryjoin参数，明确关联条件

# 先定义引擎和Base
engine = create_engine('***', connect_args={'options': '-csearch_path={}'.format('flaskProject')})
Base = declarative_base(engine)
Base.query = db.session.query_property()

# 先定义业务表
class Users(UserMixin, Base):
    __tablename__ = 'users'
    __table_args__ = {'schema': 'flaskProject'}

    id = Column(Integer, primary_key=True)
    username = Column(String)
    email = Column(String)
    password_hash = Column(String)

    # 多对多关系配置
    role = relationship(
        "Roles",
        secondary=user_role
    )


class Roles(Base):
    __table_args__ = {'schema': 'flaskProject'}
    __tablename__ = 'roles'

    id = Column(Integer, primary_key=True)
    name = Column(String)


# 再定义中间表，外键引用实际的物理表名，补充schema
user_role = Table(
    'user_role',
    Base.metadata,
    Column('userId', Integer, ForeignKey("flaskProject.users.id")),
    Column('roleId', Integer, ForeignKey("flaskProject.roles.id")),
    schema='flaskProject'
)

• 定义完所有表后，执行from sqlalchemy import inspect; inspect(engine).get_foreign_keys('user_role', schema='flaskProject')，查看中间表的外键是否能被正确解析到业务表的主键上
• 不要混淆映射类名和__tablename__对应的物理表名，SQLAlchemy的表关联逻辑完全基于物理表名匹配

注意：如果你的数据库中已经提前存在user_role表，需要确认数据库层面的外键约束和代码定义一致，否则也会触发检测失败。

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