System.Linq.Dynamic.Core 中自定义函数参数传递问题解析

问题背景

在使用 System.Linq.Dynamic.Core 这个强大的动态 LINQ 表达式解析库时，开发者经常会遇到需要自定义函数的情况。本文探讨一个典型场景：如何在动态表达式中正确传递参数给自定义函数。

核心问题

开发者在尝试使用自定义函数 PgJson.JsonbPathExists 时遇到了参数传递问题。该函数设计用于 PostgreSQL 的 jsonb_path_exists 功能，需要接收三个参数：

1. JSON 文档对象
2. JSONPath 表达式字符串
3. 包含变量的 JSON 文档

错误分析

原始代码报错信息显示："No property or field '1' exists in type 'IDynamicEntity'"，这表明解析器无法正确处理参数索引。经过排查，发现问题出在参数传递方式上 - 开发者错误地使用了 IEnumerable 集合而不是 params 数组来传递参数。

解决方案

正确的做法是使用 params 数组方式传递参数。以下是修正后的关键代码示例：

var innerLambda = DynamicExpressionParser.ParseLambda(
    DynamicFilterParser.DynamicLinqParsingConfig,
    new[] { deParam },  // 使用数组而非IEnumerable
    typeof(bool),
    dynString,
    parameters);

技术要点

1. 自定义函数标记：使用 [DynamicLinqType] 属性标记自定义函数类，确保动态 LINQ 解析器能够识别。

2. 参数类型匹配：确保动态表达式中的参数类型与函数定义严格匹配，特别是复杂类型如 JsonDocument。

3. 参数传递方式：在调用 ParseLambda 方法时，参数集合应使用数组形式而非 IEnumerable 接口。

最佳实践

1. 对于需要数据库函数映射的自定义方法，应添加 [DbFunction] 属性并抛出 NotSupportedException，如示例所示。

2. 复杂参数类型（如 JSON 文档）应在动态表达式和函数定义中保持类型一致。

3. 当遇到参数解析问题时，首先检查参数传递方式是否符合 API 要求。

总结

System.Linq.Dynamic.Core 提供了强大的动态查询能力，但在使用自定义函数时需要注意参数传递的正确方式。通过理解解析器的工作原理和遵循正确的 API 使用模式，可以避免类似 "No property or field exists" 这样的常见错误。本文案例展示了如何正确处理自定义函数参数传递，为开发者提供了实用的参考方案。