提取校验逻辑到外部函数后，LINQ表达式无法被EF Core翻译怎么办？

原本有一段可成功转换为SQL的EF Core查询代码，为复用校验逻辑将判断逻辑提取到CheckIsDaily方法后，LINQ表达式无法被EF Core转换为SQL，报错信息如下：

The LINQ expression 'DbSet().Where(m => MachineUtils.CheckIsDaily(m))' could not be translated

原始可运行代码 #

public class MachineUtils 
{
    public static Expression<Func<Machine, bool>> IsDaily()
    {
        return model => (model.Distribution == EmailType.Daily) ||
                         model.IncludeMail;
    }
}

var query = _dbContext.Machines.AsNoTracking().Where(MachineUtils.IsDaily());

改写后出问题的代码 #

public class MachineUtils 
{
    public static bool CheckIsDaily(IMachine model)
    {
        return (model.Distribution == EmailType.Daily) ||
                model.IncludeMail;
    }

    public static Expression<Func<Machine, bool>> IsDaily()
    {
        return model => CheckIsDaily(model);
    }
}

解决方案 #

方法1：复用表达式逻辑，同时提供表达式和普通方法 #

将核心校验逻辑定义为表达式，普通方法通过编译表达式实现，这样逻辑仅需维护一处，同时支持EF Core查询（用表达式）和内存中校验（用普通方法）：

public class MachineUtils 
{
    // 定义供EF Core查询使用的表达式
    public static Expression<Func<IMachine, bool>> IsDailyExpression()
    {
        return model => (model.Distribution == EmailType.Daily) || model.IncludeMail;
    }

    // 编译表达式得到委托，用于内存中的实体校验
    public static bool CheckIsDaily(IMachine model)
    {
        return IsDailyExpression().Compile()(model);
    }

    // 供Machine类型EF查询使用的便捷表达式方法
    public static Expression<Func<Machine, bool>> IsDaily()
    {
        // 若IMachine是Machine的接口，可直接转换（需确保类型兼容）
        return IsDailyExpression() as Expression<Func<Machine, bool>>;
        // 若转换有问题，也可直接复用表达式逻辑：
        // return model => (model.Distribution == EmailType.Daily) || model.IncludeMail;
    }
}

方法2：使用EF Core可翻译函数（EF Core 3.0+） #

将校验方法拆分为数据库可识别的参数，通过[DbFunction]特性标记，让EF Core能将其转换为SQL：

public class MachineUtils 
{
    [DbFunction]
    public static bool CheckIsDaily(EmailType distribution, bool includeMail)
    {
        return (distribution == EmailType.Daily) || includeMail;
    }

    public static Expression<Func<Machine, bool>> IsDaily()
    {
        return model => CheckIsDaily(model.Distribution, model.IncludeMail);
    }
}

然后在你的DbContext中注册该函数：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.HasDbFunction(() => MachineUtils.CheckIsDaily(default, default));
}

问题原因 #

EF Core只能识别表达式树中的成员访问、运算符、预定义可翻译函数等结构，无法解析普通.NET方法内部的逻辑。当在表达式中调用CheckIsDaily时，EF Core无法将该方法调用转换为对应的SQL条件，因此抛出转换失败的错误。

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