Tortoise ORM如何基于已有中间表定义多对多关联关系

你遇到的冲突本质是：当前WorkspaceUser是带额外role字段的自定义多对多中间表，Tortoise-ORM不会自动为这种自定义中间表生成跨模型的多对多关联；直接加关联字段报错，是因为默认生成的反向关联名和你在外键里定义的workspace_users反向引用重名，且没有显式绑定已存在的中间表。

你可以选以下两种方案实现需求： #

方案1：显式配置多对多关联，直接支持user.workspaces.all()写法 #

不需要修改现有数据库表结构，只要调整模型字段配置，显式绑定已有的中间表，重命名冲突的反向关联即可：

from tortoise import models, fields
from enum import Enum

class WorkspaceUserRole(str, Enum):
    owner = "owner"
    collaborator = "collaborator"

class User(models.Model):
    id = fields.UUIDField(pk=True)
    # 绑定现有中间表，指定关联键，避免表结构重复创建
    workspaces = fields.ManyToManyField(
        "models.Workspace",
        related_name="members",
        through="workspaceuser",
        forward_key="workspace_id",
        backward_key="user_id"
    )

class Workspace(models.Model):
    id = fields.UUIDField(pk=True)

class WorkspaceUser(models.Model):
    id = fields.UUIDField(pk=True)
    # 修改外键的反向关联名，避免和多对多字段重名冲突
    user = fields.ForeignKeyField("models.User", related_name="workspace_role_links")
    workspace = fields.ForeignKeyField("models.Workspace", related_name="user_role_links")
    role = fields.CharEnumField(WorkspaceUserRole)

配置完成后你写的workspaces = await user.workspaces.all()可以直接运行。如果需要同时拿到用户在每个工作区的角色，直接走中间表反向字段查询即可：

# 拿到当前用户所有工作区关联，带角色信息
links = await user.workspace_role_links.all().prefetch_related("workspace")
for link in links:
    print(link.workspace.id, link.role)

方案2：不修改模型定义，通过现有外键反向查询 #

如果你不想调整模型字段，不用加任何新关联，直接用已有的外键反向关系就能查到结果，只是写法不是你要的直接属性访问形式：

user = ... # 已取出的User实例
# 先查中间表关联，预加载工作区数据后提取结果
links = await user.workspace_users.all().prefetch_related("workspace")
workspaces = [item.workspace for item in links]

注意：如果使用方案1，执行迁移时要跳过中间表的创建逻辑，因为workspaceuser表已经存在，只要保证through、forward_key、backward_key三个参数和你现有表结构完全一致，就不会产生表冲突。

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