C# LINQ：避免Where子句中扩展方法/谓词的延迟执行（NHibernate）

NHibernate的LINQ查询并非直接执行内存中的.NET方法，而是解析表达式树生成对应SQL语句。原生Contains是NHibernate LINQ提供程序预先支持的方法，有成熟的SQL翻译逻辑；而你自定义的.In扩展方法，NHibernate无法识别其表达式树——既不会执行你的方法（所以断点不触发），也无法生成合法SQL，最终导致报错。

方案1：为自定义扩展方法添加NHibernate LINQ翻译器 #

给.In方法编写HQL生成器，让NHibernate知道如何将该方法调用转换为SQL。

步骤1：保留原有扩展方法定义 #

public static class StringExtensions
{
    public static bool In(this string source, string target)
    {
        return source.Contains(target);
    }
}

步骤2：实现自定义HQL生成器 #

using NHibernate.Hql.Ast;
using NHibernate.Linq.Functions;
using System.Reflection;
using System.Collections.ObjectModel;

public class InMethodGenerator : BaseHqlGeneratorForMethod
{
    public InMethodGenerator()
    {
        // 注册要翻译的方法：匹配StringExtensions.In的方法签名
        SupportedMethods = new[] { 
            typeof(StringExtensions).GetMethod(nameof(StringExtensions.In), 
                new[] { typeof(string), typeof(string) }) 
        };
    }

    public override HqlTreeNode BuildHql(MethodInfo method, System.Linq.Expressions.Expression targetObject, 
        ReadOnlyCollection<System.Linq.Expressions.Expression> arguments, HqlTreeBuilder treeBuilder, 
        IHqlExpressionVisitor visitor)
    {
        // 将source.In(target)转换为NHibernate能识别的contains函数调用
        var sourceExpr = visitor.Visit(arguments[0]).AsExpression();
        var targetExpr = visitor.Visit(arguments[1]).AsExpression();
        return treeBuilder.BooleanMethodCall("contains", sourceExpr, targetExpr);
    }
}

步骤3：注册生成器到NHibernate配置 #

在NHibernate初始化阶段，把自定义生成器添加到LINQ函数注册表：

var configuration = new Configuration();
// 其他配置逻辑...

var linqGeneratorRegistry = new DefaultLinqToHqlGeneratorsRegistry();
linqGeneratorRegistry.RegisterGenerator(
    typeof(StringExtensions).GetMethod(nameof(StringExtensions.In)), 
    new InMethodGenerator());

configuration.LinqToHqlGeneratorsRegistry<LinqToHqlGeneratorsRegistry>(linqGeneratorRegistry);

完成后NHibernate就能识别.In方法，正确生成SQL，同时保留延迟执行特性。

方案2：用表达式树包装原生Contains逻辑 #

如果不想自定义翻译器，可以直接构建等价的表达式树，复用NHibernate已支持的Contains逻辑。

实现返回表达式树的方法 #

public static class QueryExtensions
{
    public static Expression<Func<MyEntity, bool>> IdIn(this string ids)
    {
        return entity => ids.Contains($"|{entity.Id}|");
    }
}

使用方式 #

var query = currentSession.Query<MyEntity>()
    .Where(Ids.IdIn())
    .Select(y => y);

这种方式下，传递给Where的是NHibernate可识别的表达式树，会被正确转换为SQL，同时保持延迟执行的特性。

• NHibernate LINQ查询中，所有方法调用必须能被解析为SQL，否则必然报错；
• 断点不触发是因为NHibernate仅解析表达式树，不会实际执行你的扩展方法代码——只有调用ToList等触发内存执行的方法时，才会运行.NET方法，但这会失去ORM查询的性能优势。

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