4. Ent Edge 与关系：一对一、一对多、多对多关系定义、反向引用与级联操作

在 Ent ORM 中，Edge（边） 是定义实体之间关系的核心概念。它对应数据库中的外键、中间表以及关联查询。本章将系统讲解 Ent 支持的三种关系类型、反向引用的自动推导机制，以及级联操作在生产环境中的正确配置。

4.1 关系类型总览

Ent 使用 Edges 方法在 Schema 中声明关系。下表对比了三种关系在数据库层面的实现差异：

4.2 一对一关系：用户与身份证

一对一关系要求外键列具有唯一约束。以下示例定义 User 和 IDCard 实体：

// ent/schema/user.go
func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("id_card", IDCard.Type).
            Unique(),  // 关键：确保一对一
    }
}

// ent/schema/id_card.go
func (IDCard) Edges() []ent.Edge {
    return []ent.Edge{
        edge.From("owner", User.Type).
            Ref("id_card").
            Unique(),  // 反向引用也必须 Unique
    }
}

4.3 一对多关系：用户与订单

一对多是最常用的关系。外键在“多”的一方（Order）声明，且不加 Unique()：

// ent/schema/user.go
func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("orders", Order.Type),
    }
}

// ent/schema/order.go
func (Order) Edges() []ent.Edge {
    return []ent.Edge{
        edge.From("owner", User.Type).
            Ref("orders").
            Unique(),  // 外键在 Order 表，必须 Unique 标记主键归属
    }
}

生成的 API 使用示例：

// 创建订单并关联用户
client.Order.Create().
    SetOwnerID(userID).
    SetAmount(99.9).
    Save(ctx)

// 查询用户的所有订单
orders, _ := client.User.Query().
    Where(user.ID(userID)).
    QueryOrders().
    All(ctx)

4.4 多对多关系：用户与角色

多对多关系通过 Through 方法指定中间表。Ent 会自动生成关联表及 CRUD 方法：

// ent/schema/user.go
func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("roles", Role.Type).
            Through("user_roles", UserRole.Type),
    }
}

// ent/schema/role.go
func (Role) Edges() []ent.Edge {
    return []ent.Edge{
        edge.From("users", User.Type).
            Ref("roles").
            Through("user_roles", UserRole.Type),
    }
}

// ent/schema/user_role.go（中间表）
func (UserRole) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("user", User.Type).Unique(),
        edge.To("role", Role.Type).Unique(),
    }
}

4.5 反向引用与自动推导

Ent 通过 Ref 方法自动推导反向引用。核心规则如下：

• 正向引用（edge.To）：定义在拥有外键或中间表的实体上。
• 反向引用（edge.From + Ref）：定义在被引用的实体上，Ref 参数必须与正向引用的边名称一致。
• 类型匹配：Unique() 必须在正向和反向两端保持一致，否则代码生成会报错。

以下 SVG 图展示了三种关系的边定义与数据库映射：

4.6 级联操作配置

级联操作控制当父实体被删除或更新时，关联子实体的行为。Ent 通过 OnDelete 方法配置：

配置示例：

// ent/schema/user.go
func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("orders", Order.Type).
            OnDelete(cascade.Cascade),  // 删除用户时级联删除所有订单
    }
}

// ent/schema/order.go
func (Order) Edges() []ent.Edge {
    return []ent.Edge{
        edge.From("owner", User.Type).
            Ref("orders").
            Unique().
            OnDelete(cascade.SetNull),  // 删除用户时将外键置空
    }
}

4.7 实战：认证系统中的关系设计

在认证系统中，典型的关系组合如下：

// ent/schema/user.go
func (User) Edges() []ent.Edge {
    return []ent.Edge{
        // 一对一：用户 ↔ 认证信息
        edge.To("auth", Auth.Type).Unique(),

        // 一对多：用户 ↔ 会话
        edge.To("sessions", Session.Type),

        // 多对多：用户 ↔ 角色（通过中间表携带过期时间）
        edge.To("roles", Role.Type).
            Through("user_roles", UserRole.Type),

        // 级联：删除用户时清理所有会话，但保留角色关联记录
        edge.To("sessions", Session.Type).
            OnDelete(cascade.Cascade),
    }
}

该设计确保：

• 每个用户有且仅有一个认证记录（一对一）。
• 用户可拥有多个活跃会话（一对多），用户删除时会话自动清理。
• 用户与角色通过中间表关联，支持未来扩展权限字段。