Owned Types是依附于拥有实体的值对象，无主键和独立表，字段直接映射到拥有者表中；普通实体则必须有Id并映射为独立表。

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

EF Core 中 Owned Types 是什么，和普通实体有什么区别 Owned Types（拥有类型）不是独立实体，没有自己的主键或数据库表，它只是依附于某个拥有它的实体（Owner），所有字段都直接映射到拥有者的表中。这和值对象（Value Object）语义高度一致：比如 Address、Money、FullName 这类无身份、仅靠值相等判断的对象，就适合用 Owned Type 表达。 关键区别在于：

• 普通实体必须有 Id，会被 EF Core 映射为独立表；Owned Type 没有 Id，也不允许被导航到其他实体
• Owned Type 的属性默认全部映射到拥有者表的同名列（如 Owner.Address.Street → Address_Street），但可自定义前缀或列名
• 不能被多个实体共享引用（即不支持“一对多”中的“多”是同一个 Owned Type 实例）

如何在 EF Core 中声明和配置 Owned Type 最常用方式是通过 OwnsOne（一对一）或 OwnsMany（一对多）在 OnModelCreating 中显式声明：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Order>()
        .OwnsOne(o => o.ShippingAddress, sa =>
        {
            sa.Property(a => a.Street).HasColumnName("ShippingStreet");
            sa.Property(a => a.City).HasColumnName("ShippingCity");
        });
}

注意几点：

• 值对象类（如 Address）不能有公共无参构造函数（否则 EF 可能误判为实体），推荐用私有构造 + 公共静态工厂方法
• OwnsOne 要求该属性是引用类型且可为空（Address?），而 OwnsMany 要求是 IEnumerable<t></t> 或具体集合类型（如 List<item></item>）
• 若值对象含嵌套 Owned Type（如 Address 内含 GeoLocation），需链式调用 OwnsOne，不能省略

为什么用 OwnsOne 时 Address 属性变成 null，但数据库里字段有值 这是常见反直觉问题：EF Core 默认不会自动加载 Owned Type，即使它和拥有者在同一个表里。查询时若没显式包含，Address 字段会是 null，哪怕数据库对应列非空。 解决办法只有两种：

• 用 Include + ThenInclude（仅限 OwnsOne）：context.Orders.Include(o => o.ShippingAddress)
• 用 Select 投影到 DTO 或匿名类型（更轻量，避免代理实例化）

另外要注意：如果值对象类含只读属性（如 public string FullAddress { get; }），EF Core 无法设值，会导致加载失败或静默跳过 —— 必须提供可 set 的属性，或用 Property(...).HasField("_field") 绑定私有字段。

Owned Type 和 ComplexType（EF6）/ ValueObject（手动映射）比有什么坑 EF Core 的 Owned Type 看似简化了值对象映射，但实际有几处容易踩空：

• 不支持跨实体复用同一 Owned Type 类型（比如 User.Address 和 Order.Address 都用 Address 类，但它们在模型中是两个独立的 Owned Type 配置，不能共用配置逻辑）
• 迁移生成列名默认带前缀（如 Address_Street），若已有表结构不匹配，必须用 HasColumnName 显式对齐，否则迁移会删列重建
• 无法为 Owned Type 单独加索引或唯一约束（只能在拥有者表上建复合索引），这对某些业务校验（如 “每个用户邮箱唯一”）不适用 —— 此时应改用独立实体

值对象是否真该用 Owned Type，取决于它是否「永远不脱离拥有者存在」以及「是否需要被查询条件直接过滤」。如果经常要按 Address.City = 'Beijing' 查询订单，那它大概率不该是 Owned Type。