EF Core中无需新建表如何在单个字段存储值对象集合

EF Core 无需额外表存储值对象集合的两种实现方案 #

方案1：EF Core 8+ 原生JSON列映射（首选）

EF Core 8 及以上版本原生支持将拥有的实体集合直接映射为父表的单个JSON字段，完全适配DDD值对象无主键、不独立存在的设计要求，不会生成额外数据表。
仅需在你的DbContext的OnModelCreating方法中添加如下配置即可：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .OwnsMany(u => u.Addresses, b =>
        {
            b.ToJson(); // 核心配置：将整个Address集合序列化为JSON存储在User表字段
        });
}

优势：

• 无需修改Address值对象的定义，不需要添加主键
• 支持直接在LINQ查询中筛选Address的属性，EF Core会自动生成适配数据库的JSON查询语法，查询效率更高
• 自动处理序列化/反序列化逻辑，不需要额外编码

方案2：低版本EF Core 自定义值转换器

如果你使用的是EF Core 7及更早版本，可以通过自定义值转换器手动实现集合的序列化、反序列化：

using System.Text.Json;

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .Property(u => u.Addresses)
        .HasConversion(
            // 写入数据库时序列化
            addrs => JsonSerializer.Serialize(addrs, new JsonSerializerOptions()),
            // 从数据库读取时反序列化
            json => JsonSerializer.Deserialize<ICollection<Address>>(json, new JsonSerializerOptions()) ?? new List<Address>()
        );
}

注意事项：

• 该方案无法在数据库层面直接筛选Address内部的属性，相关过滤逻辑会在内存执行，仅适合集合规模小、不需要对值对象属性做查询的场景
• 可以根据需求选择Newtonsoft.Json或者System.Text.Json作为序列化工具

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