SQLAlchemy如何从多对多secondary中间表中获取关联的额外字段值

你遇到的问题是因为普通的secondary多对多配置下，SQLAlchemy仅将中间表用作关联桥接，不会自动加载中间表的额外字段，有两种常用的实现方式：

方式一：使用关联对象模式（推荐） #

将中间表UserAccount作为独立关联对象，拆成两组一对多关系，是带额外字段的多对多场景的官方推荐方案。

第一步：调整模型定义 #

class UserAccount:
    __tablename__ = "user_account"
    # 新增复合主键，也可以单独设置自增id作为主键
    user_id = db.Column(db.Integer, db.ForeignKey("users.id"), primary_key=True)
    account_id = db.Column(db.Integer, db.ForeignKey("accounts.id"), primary_key=True)
    role = db.Column(db.String(64), nullable=False)

    # 新增关联关系
    user = db.relationship("User", back_populates="account_associations")
    account = db.relationship("Account", back_populates="user_associations")

class User:
    id = db.Column(db.Integer, primary_key=True)
    # 新增和中间表的一对多关系
    account_associations = db.relationship("UserAccount", back_populates="user")
    # 原有的多对多关系可保留，设置viewonly避免写入冲突
    accounts = db.relationship('Account', secondary="user_account", viewonly=True)

class Account:
    id = db.Column(db.Integer, primary_key=True)
    # 新增和中间表的一对多关系
    user_associations = db.relationship("UserAccount", back_populates="account")

第二步：查询使用 #

user = User.query.first()
# 遍历关联对象即可同时拿到账号和对应角色
for assoc in user.account_associations:
    print(f"账号对象：{assoc.account}，用户角色：{assoc.role}")

方式二：联表查询（无需改动原有模型） #

如果不想调整现有模型结构，可以直接手动联表查询需要的字段：

user = User.query.first()
# 联表查询账号对象和对应角色
result = db.session.query(Account, UserAccount.role)\
    .join(UserAccount, UserAccount.account_id == Account.id)\
    .filter(UserAccount.user_id == user.id)\
    .all()

for account, role in result:
    print(f"账号对象：{account}，用户角色：{role}")

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