EF Core 7无法反序列化JSON列动态成员问题求助

问题背景 #

数据库Name列存储为动态多语言JSON格式（结构示例：{ "en": "Water", "fa": "آب", "ja": "水", ... }），该列由旧关系型数据转换而来，无法通过EF Core直接生成或交互；可用语言存储在单独表中，字段为动态定义。

T-SQL中可正常查询：

SELECT * 
FROM [MyObjects] 
WHERE JSON_VALUE(Name, '$.' + @languageCode) = @searchQuery

但EF Core执行GetAll时Name字段始终为空，尝试以下方案均无效：

• 使用带[JsonExtensionData]特性的空类
• 继承DynamicObject并实现GetDynamicMembers、TryGetMember等方法
• 直接映射为Dictionary<string, string>
• 结合上述方案并添加索引器

备选方案存在明显缺陷：回归关联表问题繁多、硬编码语言不灵活易出错、使用HasJsonConversion会大幅降低搜索性能，目前陷入困境。

一、解决Name为空的字典映射方案 #

直接映射字典类型时需显式配置EF Core列类型与序列化逻辑，避免默认配置失效：

1. 实体类定义 #

public class MyObject
{
    public int Id { get; set; }
    public Dictionary<string, string> Name { get; set; }
    // 其他业务字段
}

2. Fluent API配置 #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<MyObject>()
        .Property(o => o.Name)
        .HasColumnType("nvarchar(max)") // SQL Server可用此类型，若为PostgreSQL可指定"jsonb"
        .HasConversion(
            v => JsonSerializer.Serialize(v, null),
            v => JsonSerializer.Deserialize<Dictionary<string, string>>(v, null),
            new ValueComparer<Dictionary<string, string>>(
                (c1, c2) => c1?.SequenceEqual(c2) ?? c2 is null,
                c => c?.Aggregate(0, (a, kv) => HashCode.Combine(a, kv.Key.GetHashCode(), kv.Value.GetHashCode())) ?? 0,
                c => c?.ToDictionary(kv => kv.Key, kv => kv.Value) ?? new Dictionary<string, string>()
            )
        );
}

二、高效动态语言查询方案（规避HasJsonConversion性能问题） #

直接使用EF Core内置的EF.Functions.JsonValue方法，对应T-SQL的JSON_VALUE，查询逻辑会直接下推到数据库执行，保留原生性能：

1. 基础参数化查询 #

public async Task<List<MyObject>> SearchByLanguage(string languageCode, string searchQuery)
{
    return await _dbContext.MyObjects
        .Where(o => EF.Functions.JsonValue(o.Name, $"$.{languageCode}") == searchQuery)
        .ToListAsync();
}

2. 性能优化：创建JSON索引 #

针对高频查询的语言字段，可在数据库创建索引：

-- 针对固定常用语言创建索引
CREATE INDEX IX_MyObjects_Name_Languages ON MyObjects
(
    JSON_VALUE(Name, '$.en'),
    JSON_VALUE(Name, '$.fa'),
    JSON_VALUE(Name, '$.ja')
);

-- 若语言完全动态，可创建全文索引
CREATE FULLTEXT INDEX ON MyObjects(Name)
KEY INDEX PK_MyObjects_Id
WITH STOPLIST = OFF;

三、动态对象访问方案（如需obj.Name.en式访问） #

若需动态属性访问语法，可封装自定义动态类结合字典实现：

1. 动态包装类 #

public class DynamicLocalizedName : DynamicObject
{
    private readonly Dictionary<string, string> _languageValues;

    public DynamicLocalizedName(Dictionary<string, string> values)
    {
        _languageValues = values;
    }

    public override bool TryGetMember(GetMemberBinder binder, out object result)
    {
        if (_languageValues.TryGetValue(binder.Name, out var value))
        {
            result = value;
            return true;
        }
        result = null;
        return false;
    }

    public override IEnumerable<string> GetDynamicMemberNames()
    {
        return _languageValues.Keys;
    }

    // 可选：实现更新逻辑
    public override bool TrySetMember(SetMemberBinder binder, object value)
    {
        if (value is string strValue)
        {
            _languageValues[binder.Name] = strValue;
            return true;
        }
        return false;
    }
}

2. 实体类适配 #

public class MyObject
{
    public int Id { get; set; }
    
    // 映射数据库列的字典字段
    [Column("Name")]
    public Dictionary<string, string> NameDictionary { get; set; }

    // 动态访问属性，标记为非映射
    [NotMapped]
    public dynamic Name => new DynamicLocalizedName(NameDictionary);

    // 其他业务字段
}

关键注意事项 #

• 禁止使用HasJsonConversion做整体序列化查询：该方式会将所有JSON列反序列化到内存后过滤，性能损耗极大；而EF.Functions.JsonValue会直接转换为原生SQL在数据库端执行过滤。
• 数据库类型适配：若使用PostgreSQL，需将列类型指定为jsonb以支持索引与高效查询。
• 动态语言场景：若语言完全无规律，可考虑定时同步常用语言到计算列并创建索引，平衡灵活性与性能。

内容的提问来源于stack exchange，提问作者Soraya V.