EF Core如何将App类集合属性存储为JSON而非单独表

问题根源 #

OwnsMany 配置默认会为集合类型的Owned实体生成单独的关联表，这和你希望把集合直接存在Apps表JSON列的需求冲突。要实现目标，需要结合EF Core的值转换器或原生JSON支持（EF Core 5+开始提供）来处理这类集合属性。

具体配置步骤 #

1. 保持实体类标记 #

保留FieldStructure和FieldStructureRelation的[Owned]特性，App类的集合属性无需额外特性：

public class App
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List<FieldStructure> Fields { get; set; }
    public List<FieldStructureRelation> RelationFields { get; set; }
}

[Owned]
public class FieldStructure
{
    public string FieldName { get; set; }
    public string Type { get; set; }
    // 其他自定义属性
}

[Owned]
public class FieldStructureRelation
{
    public string SourceField { get; set; }
    public string TargetField { get; set; }
    // 其他自定义属性
}

2. 在DbContext中配置JSON存储 #

在OnModelCreating方法里，针对App的集合属性配置JSON序列化规则，将集合转为JSON字符串存入对应列。

方法一：原生JSON支持（推荐，EF Core 5+）

如果你的数据库支持JSON列（如SQL Server、PostgreSQL、MySQL），直接配置对应列类型并绑定序列化逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<App>(entity =>
    {
        // 配置Fields为JSON列
        entity.Property(e => e.Fields)
              .HasColumnType("json") // 不同数据库调整类型：SQL Server用"nvarchar(max)"，PostgreSQL用"jsonb"，MySQL用"json"
              .HasConversion(
                  v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
                  v => JsonSerializer.Deserialize<List<FieldStructure>>(v, (JsonSerializerOptions)null)
              );

        // 配置RelationFields为JSON列
        entity.Property(e => e.RelationFields)
              .HasColumnType("json")
              .HasConversion(
                  v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
                  v => JsonSerializer.Deserialize<List<FieldStructureRelation>>(v, (JsonSerializerOptions)null)
              );
    });
}

方法二：自定义值转换器（兼容EF Core 3.x及更早版本）

如果使用旧版EF Core，可自定义转换器处理序列化：

public class JsonListConverter<T> : ValueConverter<List<T>, string>
{
    public JsonListConverter() : base(
        v => JsonSerializer.Serialize(v, new JsonSerializerOptions { WriteIndented = false }),
        v => JsonSerializer.Deserialize<List<T>>(v, new JsonSerializerOptions { PropertyNameCaseInsensitive = true })
    )
    {
    }
}

// 在OnModelCreating中应用
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<App>(entity =>
    {
        entity.Property(e => e.Fields)
              .HasConversion(new JsonListConverter<FieldStructure>())
              .HasColumnType("nvarchar(max)");

        entity.Property(e => e.RelationFields)
              .HasConversion(new JsonListConverter<FieldStructureRelation>())
              .HasColumnType("nvarchar(max)");
    });
}

3. 清理冲突配置 #

删除之前添加的OwnsMany相关代码，避免EF Core继续生成关联表。

验证效果 #

执行数据库迁移或更新后，Apps表会新增Fields和RelationFields两个JSON类型列，不会生成AppFields或AppRelationFields这类额外表。

内容的提问来源于stack exchange，提问作者Nono-Man