使用EF Core存入Cosmos DB时，JsonElement字段无法正常持久化

你遇到的情况是EF Core操作Cosmos DB时，JsonElement类型的JobParams字段仅被存为{ ValueKind:1 }，而字符串类型的字段能正常保存——这是因为EF Core Cosmos提供程序默认没有正确处理JsonElement的序列化逻辑，只存储了它的类型枚举值而非实际数据。

以下是几种可行的解决方案：

方法1：添加自定义值转换器 #

在EF Core的模型配置中，为JsonElement字段添加值转换器，将其序列化为JSON字符串存储，读取时再反序列化为JsonElement：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<YourEntity>()
        .Property(e => e.JobParams)
        .HasConversion(
            jsonElement => jsonElement.ToString(),
            jsonString => JsonSerializer.Deserialize<JsonElement>(jsonString)
        );
}

方法2：改用JsonNode类型替代JsonElement #

从.NET 7开始，EF Core Cosmos提供程序原生支持JsonNode类型的序列化。如果你的JobParams是HashMap结构，直接替换JsonElement为JsonObject，无需额外配置即可正常持久化：

public class YourEntity
{
    // 替换原JsonElement类型为JsonObject（匹配HashMap结构）
    public JsonObject JobParams { get; set; }
}

方法3：配置EF Core使用System.Text.Json直接处理字段 #

若需保留JsonElement类型，可在模型配置中指定该字段通过System.Text.Json直接序列化，绕过EF Core的默认处理逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<YourEntity>()
        .Property(e => e.JobParams)
        .HasJsonPropertyName("JobParams")
        .HasConversion(
            v => JsonSerializer.SerializeToNode(v),
            v => JsonSerializer.Deserialize<JsonElement>(v!.ToJsonString())
        );
}

配置完成后重新运行数据写入逻辑，Cosmos DB中的JobParams字段会正确存储你的HashMap结构数据，其他客户端可正常读取调用。

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