EF Core 3.1对接PostgreSQL如何将集合属性映射为jsonb而非生成单独表

前提确认 #

首先确保你已经安装了PostgreSQL EF Core提供程序的NuGet包：Npgsql.EntityFrameworkCore.PostgreSQL，版本要和你使用的EF Core 3.x版本匹配。

Fluent API 配置方式 #

你遇到的问题是EF Core默认将自定义类的集合属性识别为一对多导航属性，所以会自动生成Address对应的数据表。你需要通过配置明确告诉EF该属性是普通的jsonb类型标量字段，而非导航属性，以下是两种可行配置方式：

方式1：使用Npgsql原生jsonb映射（推荐） #

Npgsql提供程序原生支持jsonb类型的自动序列化/反序列化，直接配置列类型即可：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Person>(entity =>
    {
        entity.Property(p => p.Addresses)
            .HasColumnType("jsonb")
            .IsRequired(); // 按需配置是否必填
    });

    // 若EF仍识别Address为独立实体，添加以下配置禁止Address作为表实体映射
    modelBuilder.Ignore<Address>();
}

方式2：自定义值转换器（兼容自定义序列化逻辑） #

如果你需要控制序列化规则（比如自定义命名策略、忽略空值等），可以显式配置序列化转换器：

using System.Text.Json;

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Person>(entity =>
    {
        entity.Property(p => p.Addresses)
            .HasColumnType("jsonb")
            .HasConversion(
                // 序列化：将C#集合转为json字符串
                list => JsonSerializer.Serialize(list, new JsonSerializerOptions 
                { 
                    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
                    IgnoreNullValues = true
                }),
                // 反序列化：将json字符串转回C#集合
                jsonStr => JsonSerializer.Deserialize<IList<Address>>(jsonStr, new JsonSerializerOptions 
                { 
                    PropertyNamingPolicy = JsonNamingPolicy.CamelCase 
                })
            )
            .IsRequired();
    });
}

如果你使用Newtonsoft.Json作为序列化组件，替换上述序列化/反序列化逻辑为JsonConvert.SerializeObject和JsonConvert.DeserializeObject即可。

验证配置 #

配置完成后删除之前生成的错误迁移文件，重新执行Add-Migration命令生成迁移脚本，检查生成的迁移代码：

• 不存在创建Address表的CreateTable语句
• Person表的Addresses字段类型为jsonb
  符合以上两点说明配置正确，执行Update-Database即可生成符合预期的表结构。

注意事项 #

• 不要将Address类添加到DbContext的DbSet<>属性中
• 不要在其他实体配置中将Address类作为独立实体进行配置

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