如何在TypeORM中实现三方多对多关系？附示例说明

当然可以在TypeORM中实现三方多对多关系！不过得先明确：TypeORM原生的@ManyToMany装饰器仅支持两个实体之间的关联，三方（或更多方）的关联需要我们手动创建一个中间关联实体来衔接所有相关实体。

典型场景示例 #

最常见的场景之一是用户在某个项目中承担特定角色：

• 一个用户可以在多个项目中拥有不同角色
• 一个项目可以有多个用户，每个用户对应不同角色
• 一个角色可以被多个用户在不同项目中使用
  这三个实体（User、Project、Role）就形成了典型的三方关联模式。

实现步骤（代码示例） #

我们需要先定义三个核心实体，再创建一个中间关联实体来连接它们。

1. 定义核心实体

User 实体

import { Entity, PrimaryGeneratedColumn, Column, OneToMany } from "typeorm";
import { UserProjectRole } from "./UserProjectRole";

@Entity()
export class User {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;

  // 与中间实体建立一对多关系
  @OneToMany(() => UserProjectRole, upr => upr.user)
  userProjectRoles: UserProjectRole[];
}

Project 实体

import { Entity, PrimaryGeneratedColumn, Column, OneToMany } from "typeorm";
import { UserProjectRole } from "./UserProjectRole";

@Entity()
export class Project {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;

  @OneToMany(() => UserProjectRole, upr => upr.project)
  userProjectRoles: UserProjectRole[];
}

Role 实体

import { Entity, PrimaryGeneratedColumn, Column, OneToMany } from "typeorm";
import { UserProjectRole } from "./UserProjectRole";

@Entity()
export class Role {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string; // 例如："管理员"、"开发者"、"测试员"

  @OneToMany(() => UserProjectRole, upr => upr.role)
  userProjectRoles: UserProjectRole[];
}

2. 创建中间关联实体

这个实体将包含三个外键，分别关联上述三个核心实体，同时可以添加额外的业务字段（比如关联创建时间）。

import { Entity, PrimaryGeneratedColumn, ManyToOne, JoinColumn, Column } from "typeorm";
import { User } from "./User";
import { Project } from "./Project";
import { Role } from "./Role";

@Entity()
export class UserProjectRole {
  // 可选：使用自增主键
  @PrimaryGeneratedColumn()
  id: number;

  // 关联 User 实体
  @ManyToOne(() => User, user => user.userProjectRoles, { onDelete: "CASCADE" })
  @JoinColumn({ name: "userId" })
  user: User;
  @Column()
  userId: number;

  // 关联 Project 实体
  @ManyToOne(() => Project, project => project.userProjectRoles, { onDelete: "CASCADE" })
  @JoinColumn({ name: "projectId" })
  project: Project;
  @Column()
  projectId: number;

  // 关联 Role 实体
  @ManyToOne(() => Role, role => role.userProjectRoles, { onDelete: "CASCADE" })
  @JoinColumn({ name: "roleId" })
  role: Role;
  @Column()
  roleId: number;

  // 额外字段示例：关联创建时间
  @Column({ type: "datetime", default: () => "CURRENT_TIMESTAMP" })
  createdAt: Date;
}

使用示例 #

查询某个用户在所有项目中的角色信息：

const user = await userRepository.findOne({
  where: { id: 1 },
  relations: ["userProjectRoles", "userProjectRoles.project", "userProjectRoles.role"]
});

// 遍历输出用户的项目角色
user?.userProjectRoles.forEach(upr => {
  console.log(`用户${user.name}在项目${upr.project.name}中的角色是${upr.role.name}`);
});

关键注意事项 #

• 避免重复关联：如果需要限制同一个用户在同一个项目中只能拥有一个角色，可以把userId、projectId、roleId设置为联合主键，替换自增主键：

  // 替换自增主键为联合主键
  @PrimaryColumn()
  userId: number;
  
  @PrimaryColumn()
  projectId: number;
  
  @PrimaryColumn()
  roleId: number;
  

• 级联操作：根据业务需求设置onDelete、onUpdate等级联规则，比如{ onDelete: "CASCADE" }表示当关联的核心实体被删除时，中间表的对应记录也会被删除。

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