EF Core Linq Where匹配对象列表复合主键报翻译错误解决方案

EF Core的查询翻译器无法将内存集合上的多字段匹配Any逻辑转换为可执行的SQL语句。
默认情况下EF Core仅支持将内存集合的单字段Contains调用翻译为SQL的IN语法，你当前的写法是在Any中同时判断两个主键字段与传入集合内的元素匹配，属于复合值匹配逻辑，EF Core没有内置对应翻译规则时就会抛出无法翻译的异常，提示你改写查询或者切换到客户端评估——客户端评估会把全表数据拉到内存再过滤，性能极差，非极端场景不推荐使用。

以下两种方案都可以实现数据库侧执行过滤，不需要拉取全表数据：

方案1：动态拼接表达式树（兼容所有EF Core版本） #

核心逻辑是把每个传入的复合主键转换为单组等值判断条件，再将所有条件用OR拼接为完整的WHERE谓词，EF Core可以正常将这类表达式翻译为多组OR拼接的SQL语句，在数据库侧完成过滤。
实现代码如下：

public async Task<IList<AccountingAccountCategoryMap>> GetList(IEnumerable<AccountingAccountCategoryKey> keys)
{
    var keyList = keys.ToList();
    // 传入key为空时直接返回空结果，避免生成无效SQL
    if (!keyList.Any())
        return new List<AccountingAccountCategoryMap>();
    
    var parameter = Expression.Parameter(typeof(AccountingAccountCategoryMap), "item");
    Expression? predicateBody = null;
    foreach (var key in keyList)
    {
        // 构造单组key的匹配条件：item.CategoryId == key.CategoryId && item.AccountingAccountId == key.AccountingAccountId
        var categoryMatch = Expression.Equal(
            Expression.Property(parameter, nameof(AccountingAccountCategoryMap.CategoryId)),
            Expression.Constant(key.CategoryId)
        );
        var accountMatch = Expression.Equal(
            Expression.Property(parameter, nameof(AccountingAccountCategoryMap.AccountingAccountId)),
            Expression.Constant(key.AccountingAccountId)
        );
        var singleKeyPredicate = Expression.AndAlso(categoryMatch, accountMatch);
        predicateBody = predicateBody == null 
            ? singleKeyPredicate 
            : Expression.OrElse(predicateBody, singleKeyPredicate);
    }
    var finalPredicate = Expression.Lambda<Func<AccountingAccountCategoryMap, bool>>(predicateBody!, parameter);
    return await Query.Where(finalPredicate).ToListAsync();
}

这个方案兼容性最好，不需要升级依赖，缺点是如果传入的主键数量超过千条，生成的SQL语句会过长，可能影响数据库解析和执行效率。

方案2：使用EF Core 7.0+ 原生值元组Contains支持（代码最简洁） #

EF Core 7.0及以上版本内置了对值元组集合Contains方法的翻译能力，针对复合主键匹配场景可以直接编写简洁代码，不需要手动拼接表达式：

public async Task<IList<AccountingAccountCategoryMap>> GetList(IEnumerable<AccountingAccountCategoryKey> keys)
{
    // 将传入的主键对象转换为值元组集合
    var tupleKeys = keys.Select(k => (k.CategoryId, k.AccountingAccountId)).ToList();
    return await Query
        .Where(item => tupleKeys.Contains((item.CategoryId, item.AccountingAccountId)))
        .ToListAsync();
}

EF Core会自动根据使用的数据库类型生成适配的SQL：部分数据库（如PostgreSQL）会直接翻译为值元组的IN语法，SQL Server等数据库会自动转换为多组OR拼接的查询语句，性能和手动拼接表达式一致，符合版本要求时优先选择这个方案。

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