EF Core 8中如何将ICollection<string>映射到PostgreSQL的JSON列？

针对你遇到的问题，以下是.NET 8环境下的两种可靠解决思路：

方案1：自定义ValueConverter直接映射 #

EF Core 8默认不支持将ICollection<string>直接映射为JSONB，但可以通过值转换器手动实现序列化/反序列化逻辑：

// 在实体配置类中
builder.Property(x => x.Messages)
       .HasColumnType("jsonb")
       .HasConversion(
           // 序列化：将集合转为JSON字符串
           collection => JsonSerializer.Serialize(collection, new JsonSerializerOptions
           {
               WriteIndented = false, // 可选，减少存储体积
               DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
           }),
           // 反序列化：将JSON字符串转回集合，空值时返回空集合
           json => JsonSerializer.Deserialize<ICollection<string>>(json, new JsonSerializerOptions()) ?? []
       );

注意事项 #

• 确保你的Npgsql.EntityFrameworkCore.PostgreSQL包是8.x系列的最新版本，避免已知的JSON映射bug
• 保持序列化/反序列化的JsonSerializerOptions一致，防止数据解析异常

方案2：用包装类配合ToJson映射 #

因为OwnsOne仅支持映射实体类型而非直接的集合类型，你可以把集合包装到一个简单类中，再用EF Core的JSON映射特性：

步骤1：创建包装类 #

public class MessageContainer
{
    public ICollection<string> Items { get; set; } = [];
}

步骤2：修改实体（或用私有字段隐藏包装类） #

如果不想改变实体的对外接口，可以用私有字段+公共属性的方式：

public class YourEntity
{
    private MessageContainer _messageContainer = new();
    
    // 对外保持ICollection<string>的接口
    public ICollection<string> Messages => _messageContainer.Items;
}

步骤3：配置映射 #

// 映射私有字段的包装类，并启用JSON存储
builder.OwnsOne<MessageContainer>(
    entity => EF.Property<MessageContainer>(entity, "_messageContainer"),
    builder => builder.ToJson()
);

这样数据库中会存储Items对应的JSON数组，而非集合的Capacity属性。

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