EF Core怎么映射复杂类型 EF Core Owned Types使用教程

EF Core 映射复杂类型的核心是 Owned Entity Types，即值对象直接展平到拥有者表中，不新建表；用 record 或只读 class 定义值对象，通过 OwnsOne/OwnsMany 配置映射。

EF Core 映射复杂类型，核心就是用 Owned Entity Types（自有实体类型），它本质是官方对“值对象”的原生支持。不是新建表，也不是普通导航属性，而是把值对象的字段直接展平到拥有者的数据库表里。

怎么定义一个值对象类

值对象要体现“无标识、按值比较、不可变（推荐）”的特点：

• 用 record 最省事，自动实现 Equals 和 GetHashCode
• 或者用普通 class，手动重写相等性逻辑，确保所有属性参与比较
• 属性设为 init 或只读，避免外部随意修改

示例：

public record Address
{
    public string Street { get; init; }
    public string City { get; init; }
    public string PostalCode { get; init; }
    public string Country { get; init; }
}

怎么在实体中使用

直接作为属性声明，不需要主键、不单独映射表：

public class Order
{
    public int Id { get; set; }
    public string Number { get; set; }
    public Address ShippingAddress { get; set; } // 这里就用了
    public Address BillingAddress { get; set; }
}

注意：同一个实体里可以有多个同类型的复杂属性（比如收货地址 + 账单地址），EF Core 能区分列名。

怎么配置映射关系

必须显式告诉 EF Core 这是个自有类型，两种方式任选其一：

• 在 OnModelCreating 中调用 OwnsOne
• 给值对象类加 [Owned] 特性（EF Core 2.1+ 支持）

推荐用代码配置，更清晰可控：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .OwnsOne(o => o.ShippingAddress, sa =>
        {
            sa.Property(a => a.Street).HasColumnName("Ship_Street");
            sa.Property(a => a.City).HasColumnName("Ship_City");
            sa.Property(a => a.PostalCode).HasColumnName("Ship_PostalCode");
        });

    modelBuilder.Entity()
        .OwnsOne(o => o.BillingAddress, ba =>
        {
            ba.Property(a => a.Street).HasColumnName("Bill_Street");
            ba.Property(a => a.City).HasColumnName("Bill_City");
        });
}

这样生成的表里，Order 表会包含 Ship_Street、Bill_City 等字段，没有额外表。

集合型复杂类型怎么处理

如果一个实体要拥有多个值对象（比如客户有多个联系地址），用 OwnsMany：

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List Addresses { get; set; } = new();
}

配置方式类似：

modelBuilder.Entity()
    .OwnsMany(c => c.Addresses, a =>
    {
        a.WithOwner().HasForeignKey("CustomerId");
        a.Property(x => x.Street).HasColumnName("Addr_Street");
    });

这时会生成一张关联子表 CustomerAddresses，带外键和自增序号，但依然没有独立主键或生命周期。

基本上就这些。关键记住：复杂类型不是实体，不查库、不跟踪ID、不单独存，只依附于拥有者存在。