System.Linq.Dynamic.Core 中 OrderBy 包含 null 值的处理技巧

在 System.Linq.Dynamic.Core 1.6.3 版本中，当使用 OrderBy 方法并包含 null 值判断时，开发者可能会遇到一个常见问题。本文将深入分析这个问题及其解决方案。

问题现象

在早期版本（如 1.4.6）中，以下代码可以正常工作：

query.OrderBy("x => x.DateDelivered == null ? 1 : 2")

但在升级到 1.6.3 版本后，系统会抛出错误：

'No property or field 'null' exists in type '(Type)''

问题根源

这个问题的本质在于解析器无法正确识别 null 是一个常量表达式，而不是实体的字段。在 1.6.3 版本中，System.Linq.Dynamic.Core 引入了更严格的属性/字段检查机制。

解决方案

方法一：使用 ParsingConfig 配置

最推荐的解决方案是创建一个 ParsingConfig 实例，并设置 RestrictOrderByToPropertyOrField 为 false：

var config = new ParsingConfig()
{
    RestrictOrderByToPropertyOrField = false
};
var orderedQuery = query.OrderBy(config, "x => x.DateDelivered == null ? 1 : 2");

方法二：替代语法

也可以考虑使用以下替代语法：

query.OrderBy("DateDelivered == null ? 1 : 2")

注意事项

1. 当使用 Entity Framework 时，如果实体属性上有 Column 特性标记，即使属性存在，OrderBy 也可能会失败。例如：

[Column("DeliveredDate")]
public DateTime? DateDelivered { get; set; }

这种情况下，必须使用方法一中的配置解决方案。

2. 这种变化是 System.Linq.Dynamic.Core 1.6.0 版本引入的安全特性的一部分，旨在防止潜在的 SQL 注入风险。

最佳实践

1. 对于生产环境，建议始终使用 ParsingConfig 进行显式配置
2. 在升级 System.Linq.Dynamic.Core 版本时，应特别注意 OrderBy 相关代码的兼容性
3. 考虑在项目中使用统一的配置管理，避免散落的配置代码

通过理解这些变化和解决方案，开发者可以更安全地在项目中使用动态 LINQ 查询功能。