System.Linq.Dynamic.Core 中 Dictionary 类型动态查询的注意事项

在使用 System.Linq.Dynamic.Core 进行动态 LINQ 查询时，处理从 JSON 反序列化得到的 Dictionary<string, object> 集合与直接创建的字典集合会表现出不同的行为。本文将深入分析这一现象的原因，并提供解决方案。

问题现象

当开发者尝试对两种看似相同的 List<Dictionary<string, object>> 进行动态查询时，结果却大相径庭：

1. 直接创建的字典集合：动态查询 Where("Country == \"Belgium\"") 能正确过滤出符合条件的数据
2. 从 JSON 反序列化的字典集合：相同的查询条件却无法匹配任何数据

根本原因分析

这种差异源于两种方式创建的字典在类型信息上的微妙差别：

1. 直接创建的字典：object 值保留了原始类型信息（如字符串保持为 string 类型）
2. JSON 反序列化的字典：Newtonsoft.Json 默认会将简单类型的值转换为 JValue 类型而非原始类型

当 System.Linq.Dynamic.Core 执行动态查询时，它依赖于类型信息来正确解析和比较值。JSON 反序列化过程中丢失了原始类型信息，导致动态查询无法正确执行值比较。

解决方案

要解决这个问题，有以下几种方法：

方法一：使用专门的 Newtonsoft.Json 集成包

System.Linq.Dynamic.Core 提供了专门的 Newtonsoft.Json 集成包，可以正确处理反序列化的类型信息。

// 需要安装 Z.DynamicLinq.NewtonsoftJson 包
var data = JsonConvert.DeserializeObject<List<Dictionary<string, object>>>(
    File.ReadAllText("Files\\TestData2.json"));

var filtered = data.AsQueryable()
    .Where("Country == \"Belgium\"")
    .ToList();

方法二：手动转换值类型

在反序列化后，手动将字典中的值转换为适当的类型：

var data = JsonConvert.DeserializeObject<List<Dictionary<string, object>>>(
    File.ReadAllText("Files\\TestData2.json"));

// 转换所有值为原始类型
foreach (var dict in data)
{
    foreach (var key in dict.Keys.ToList())
    {
        if (dict[key] is JValue jValue)
        {
            dict[key] = jValue.Value;
        }
    }
}

var filtered = data.AsQueryable()
    .Where("Country == \"Belgium\"")
    .ToList();

方法三：使用强类型对象替代字典

对于结构化数据，使用强类型类通常是最佳实践：

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Country { get; set; }
}

var data = JsonConvert.DeserializeObject<List<Person>>(
    File.ReadAllText("Files\\TestData2.json"));

var filtered = data.AsQueryable()
    .Where("Country == \"Belgium\"")
    .ToList();

最佳实践建议

1. 优先使用强类型对象：在可能的情况下，使用明确的类定义而不是字典，可以获得更好的类型安全和性能
2. 了解序列化行为：当必须使用字典时，了解所用 JSON 序列化库对类型处理的方式
3. 考虑使用集成包：当处理复杂场景时，使用官方提供的集成包可以避免许多潜在问题
4. 测试验证：对于动态查询，编写单元测试验证各种边界条件下的查询行为

通过理解这些底层机制，开发者可以更有效地使用 System.Linq.Dynamic.Core 进行动态查询，避免在实际项目中遇到类似问题。