EF Core 7 JSON列属性未序列化问题求助

1. 检查嵌套类型的属性访问修饰符 #

EF Core需要能正常访问嵌套类的属性，确保Address、Order、PaymentMethod这些嵌套类的所有属性均为public。如果属性是private/internal，EF Core无法读取或写入属性值，最终会导致序列化后出现空对象。

错误写法示例：

public class Address
{
    string Street { get; set; } // 私有属性，EF无法访问
}

正确写法：

public class Address
{
    public string Street { get; set; }
    public string City { get; set; }
}

2. 修正实体配置中的集合映射 #

Orders是数组集合类型，必须用OwnsMany而非OwnsOne配置映射。用OwnsOne处理集合会导致EF无法正确识别集合元素的属性，最终序列化出空对象数组。

错误配置示例：

modelBuilder.Entity<Customer>()
    .OwnsOne(c => c.CustomerDetails, d =>
    {
        d.ToJson();
        d.OwnsOne(det => det.Address);
        d.OwnsOne(det => det.Orders); // 集合用OwnsOne是错误的
        d.OwnsOne(det => det.PaymentMethod);
    });

正确配置（集合使用OwnsMany）：

modelBuilder.Entity<Customer>()
    .OwnsOne(c => c.CustomerDetails, d =>
    {
        d.ToJson();
        d.OwnsOne(det => det.Address);
        d.OwnsMany(det => det.Orders, o =>
        {
            o.Property<int>("Id"); // EF Core要求集合元素必须有主键
            o.HasKey("Id");
        });
        d.OwnsOne(det => det.PaymentMethod);
    });

3. 确认数据赋值的完整性 #

保存实体前，要确保给CustomerDetails下的嵌套属性正确赋值，而非仅初始化空对象/空数组。

错误赋值示例：

var customer = new Customer
{
    CustomerDetails = new CustomerDetails
    {
        Address = new Address(), // 仅初始化对象，未赋值内部属性
        Orders = new List<Order> { new Order(), new Order() }, // 空Order对象
        PaymentMethod = new PaymentMethod()
    }
};

正确赋值示例：

var customer = new Customer
{
    CustomerDetails = new CustomerDetails
    {
        Address = new Address { Street = "Main St", City = "New York" },
        Orders = new List<Order> 
        { 
            new Order { OrderId = 1, Amount = 99.99m },
            new Order { OrderId = 2, Amount = 49.99m }
        },
        PaymentMethod = new PaymentMethod { Type = "CreditCard", LastFour = "1234" }
    }
};

4. 统一EF Core相关包版本 #

确认项目中所有EF Core依赖包（如Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.SqlServer等）的版本均为7.0.2，版本不一致可能引发JSON序列化的隐性bug。

5. 验证数据库列类型 #

查看迁移生成的脚本，确认CustomerDetails列是正确的JSON类型（比如SQL Server的nvarchar(max)并带有JSON约束，PostgreSQL的jsonb）。若列类型为普通字符串且无JSON约束，可能导致序列化异常。

迁移文件中的正确配置示例：

migrationBuilder.AddColumn<string>(
    name: "CustomerDetails",
    table: "Customers",
    type: "nvarchar(max)",
    nullable: true)
    .Annotation("Relational:ColumnType", "json");

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