Owned Types是依附于拥有实体的值对象，无主键和独立表，字段直接映射到拥有者表中；普通实体则必须有Id并映射为独立表。
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()
.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 或具体集合类型（如 List）
- 若值对象含嵌套 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。
Id，会被 EF Core 映射为独立表；Owned Type 没有 Id，也不允许被导航到其他实体Owner.Address.Street → Address_Street），但可自定义前缀或列名OwnsOne（一对一）或 OwnsMany（一对多）在 OnModelCreating 中显式声明：
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity()
.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或具体集合类型（如List） - 若值对象含嵌套 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。
Include + ThenInclude（仅限 OwnsOne）：context.Orders.Include(o => o.ShippingAddress)
Select 投影到 DTO 或匿名类型（更轻量，避免代理实例化）- 不支持跨实体复用同一 Owned Type 类型（比如
User.Address和Order.Address都用Address类，但它们在模型中是两个独立的 Owned Type 配置，不能共用配置逻辑） - 迁移生成列名默认带前缀（如
Address_Street），若已有表结构不匹配，必须用HasColumnName显式对齐，否则迁移会删列重建 - 无法为 Owned Type 单独加索引或唯一约束（只能在拥有者表上建复合索引），这对某些业务校验（如 “每个用户邮箱唯一”）不适用 —— 此时应改用独立实体
Address.City = 'Beijing' 查询订单，那它大概率不该是 Owned Type。
