EF Core中含搜索查询数组的LINQ查询无法转换的解决方法

我尝试用搜索查询数组对数据表的多列进行过滤，SearchQuery属性定义如下：

public string[] SearchQuery { get; set; }

我写的LINQ查询代码是：

.Where(x => request.SearchQuery == null || request.SearchQuery
    .Any(searchQuery => string.IsNullOrEmpty(searchQuery) ||
        (x.Column1 != null && x.Column1.Contains(searchQuery)) ||
        (x.Column2 != null && x.Column2.Contains(searchQuery)) ||
        (x.Column3 != null && x.Column3.Contains(searchQuery))
))

执行查询时出现如下错误：

LINQ表达式'my-expression'无法被转换。请将查询重写为可转换的形式，或通过调用'AsEnumerable'、'AsAsyncEnumerable'、'ToList'或'ToListAsync'显式切换到客户端求值。

额外背景 #

我使用了IRepository模式，查询封装在Specification类中，实现代码如下：

public sealed class ListItemsSpecification : Specification<Table>
{
    public ListItemsSpecification(MyRequest request, bool applyPagination = true)
    {
        Query
            .Where(x => request.SearchQuery == null || request.SearchQuery
               .Any(searchQuery => string.IsNullOrEmpty(searchQuery) ||
               (x.Column1 != null && x.Column1.Contains(searchQuery)) ||
               (x.Column2 != null && x.Column2.Contains(searchQuery)) ||
               (x.Column3 != null && x.Column3.Contains(searchQuery))
             ))
            .AsNoTracking();

        if (applyPagination)
            Query.ApplyListRequest(request.OrderBy, request.Sort, request.Offset, request.Limit);
    }
}

如何改写该查询使其能被Entity Framework Core转换？我也曾尝试单独构建查询，但仍出现相同错误。

EF Core无法直接转换嵌套数组Any的查询逻辑到SQL，需要换一种方式构建过滤条件，以下是几种可行方案：

方案1：动态拼接多列匹配条件（推荐） #

先过滤无效搜索词，再为每个有效词构建“任意列包含该词”的OR条件，最后合并所有条件。代码修改如下：

public sealed class ListItemsSpecification : Specification<Table>
{
    public ListItemsSpecification(MyRequest request, bool applyPagination = true)
    {
        // 过滤空值和空字符串，提取有效搜索词
        var validSearchQueries = request.SearchQuery?
            .Where(sq => !string.IsNullOrEmpty(sq))
            .ToList() ?? new List<string>();

        if (validSearchQueries.Any())
        {
            // 初始化空条件，后续用OR拼接
            Expression<Func<Table, bool>> searchCondition = x => false;

            foreach (var searchQuery in validSearchQueries)
            {
                var currentQuery = searchQuery; // 避免闭包陷阱
                // 构建当前搜索词的多列匹配逻辑
                Expression<Func<Table, bool>> currentCondition = x => 
                    (x.Column1 != null && x.Column1.Contains(currentQuery)) ||
                    (x.Column2 != null && x.Column2.Contains(currentQuery)) ||
                    (x.Column3 != null && x.Column3.Contains(currentQuery));

                // 合并条件：已有条件 OR 当前条件
                searchCondition = searchCondition.Or(currentCondition);
            }

            Query.Where(searchCondition);
        }

        Query.AsNoTracking();

        if (applyPagination)
            Query.ApplyListRequest(request.OrderBy, request.Sort, request.Offset, request.Limit);
    }
}

注意事项：

• 循环中必须将searchQuery赋值给局部变量currentQuery，避免闭包导致的变量捕获问题
• 这里用到的Or方法是Specification库（如Ardalis.Specification）的内置方法，若你的库无此方法，需自行实现表达式合并逻辑

方案2：用EF.Functions.Like优化模糊查询 #

如果需要更贴近SQL原生的模糊查询，可以替换Contains为EF.Functions.Like，它会被转换为SQL的LIKE语句：

Expression<Func<Table, bool>> currentCondition = x => 
    (x.Column1 != null && EF.Functions.Like(x.Column1, $"%{currentQuery}%")) ||
    (x.Column2 != null && EF.Functions.Like(x.Column2, $"%{currentQuery}%")) ||
    (x.Column3 != null && EF.Functions.Like(x.Column3, $"%{currentQuery}%"));

EF Core会自动参数化查询，无需担心SQL注入问题。

方案3：客户端求值（仅小数据集可用） #

如果数据量很小，可以先将数据加载到内存再过滤，但此方法会拉取全表数据，性能开销大，不推荐用于大数据场景：

Query
    .AsEnumerable() // 切换到客户端内存求值
    .Where(x => request.SearchQuery == null || request.SearchQuery
       .Any(searchQuery => string.IsNullOrEmpty(searchQuery) ||
       (x.Column1 != null && x.Column1.Contains(searchQuery)) ||
       (x.Column2 != null && x.Column2.Contains(searchQuery)) ||
       (x.Column3 != null && x.Column3.Contains(searchQuery))
     ))
    .AsQueryable() // 若后续需继续使用EF查询方法，转回IQueryable
    .AsNoTracking();

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