如何配置DbContext以正确存储IDictionary<string, object>类型属性？

问题根源 #

当Parameters字典中的object实际是JToken类型（比如从JSON请求反序列化而来）时，直接使用JsonConvert.SerializeObject会序列化JToken的内部结构（如valueKind字段），而非实际的属性值，导致数据库中存储的数据不符合预期。

解决方案 #

方案1：自定义序列化逻辑处理JToken #

修改ConfigureTask方法中Parameters的属性转换逻辑，在序列化前将JToken类型的值转换为对应的.NET原生类型：

private void ConfigureTask(EntityTypeBuilder<Task> builder)
{
    builder.HasKey(e => e.TaskId);
    builder.Property(e => e.TaskId).ValueGeneratedNever();
    builder.Property(e => e.Parameters)
        .HasConversion(
            v => JsonConvert.SerializeObject(
                v.ToDictionary(
                    k => k.Key, 
                    k => k.Value is JToken token ? token.ToObject<object>() : k.Value
                )
            ),
            v => JsonConvert.DeserializeObject<Dictionary<string, object>>(v) ?? new Dictionary<string, object>()
        )
        .HasColumnType("nvarchar(max)");
}

这段代码会遍历字典，将所有JToken类型的值转换为实际的.NET对象（如字符串、数字等）后再序列化，避免存储无效的valueKind结构。

方案2：改用System.Text.Json序列化 #

如果项目允许，替换Newtonsoft.Json为System.Text.Json，它对object类型的JSON转换更贴合原生类型：

private void ConfigureTask(EntityTypeBuilder<Task> builder)
{
    builder.HasKey(e => e.TaskId);
    builder.Property(e => e.TaskId).ValueGeneratedNever();
    builder.Property(e => e.Parameters)
        .HasConversion(
            v => JsonSerializer.Serialize(v, new JsonSerializerOptions { WriteIndented = false }),
            v => JsonSerializer.Deserialize<Dictionary<string, object>>(v) ?? new Dictionary<string, object>()
        )
        .HasColumnType("nvarchar(max)");
}

对于基础类型的object值，该方案无需额外配置即可正常序列化和反序列化。

额外修复点 #

1. CreatedOn字段映射问题：你的CreatedOn是字段而非自动属性，EF Core默认不会将其映射到数据库列。如需存储该值，改为自动属性：

public DateTime CreatedOn { get; set; } = DateTime.UtcNow;

2. Status值为空问题：检查业务代码中是否有逻辑覆盖了传入的Status值，导致数据库中存储空字符串。

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