.NET 8 EF Core动态过滤分页异常：Person查询string.Contains翻译失败

完全不需要编写所有过滤组合的查询，动态拼接过滤条件是可行的，你遇到的string.Contains无法翻译问题，本质是拼接Where子句的方式错误，而非动态过滤方案本身不可行。以下是正确的实现思路：

一、用强类型Lambda表达式拼接过滤条件 #

不要用字符串形式拼接查询条件，而是直接基于IQueryable<Person>逐步添加强类型的Where子句，EF Core能正确解析这类表达式并翻译成SQL：

// 初始化基础查询
var query = _dbContext.Persons.AsQueryable();

// 按Name模糊过滤
if (!string.IsNullOrWhiteSpace(filter.NameKeyword))
{
    query = query.Where(p => p.Name.Contains(filter.NameKeyword));
}

// 按Created时间范围过滤
if (filter.CreatedStart.HasValue)
{
    query = query.Where(p => p.Created >= filter.CreatedStart.Value);
}
if (filter.CreatedEnd.HasValue)
{
    query = query.Where(p => p.Created <= filter.CreatedEnd.Value);
}

这种方式下，string.Contains会被EF Core正确翻译成SQL的LIKE '%xxx%'（或对应数据库的模糊查询语法），不会触发翻译异常。

二、整合键集分页逻辑 #

键集分页依赖上一页最后一条记录的唯一标识（比如Created+Id，避免时间重复导致分页混乱），在过滤后的查询基础上添加分页条件即可：

// 假设上一页返回的最后一条数据的Created和Id为lastCreated、lastId
if (lastCreated.HasValue && lastId.HasValue)
{
    query = query.Where(p => p.Created > lastCreated.Value 
                            || (p.Created == lastCreated.Value && p.Id > lastId.Value));
}

// 执行分页查询，排序字段需与键集条件对应
var pageData = await query.OrderBy(p => p.Created)
                          .ThenBy(p => p.Id)
                          .Take(pageSize)
                          .ToListAsync();

三、避坑提醒 #

避免使用动态字符串解析类的方式（比如通过字符串拼接Where条件、使用第三方动态LINQ库的字符串查询语法），这类方式才会导致EF Core无法正确翻译string.Contains等方法。强类型Lambda拼接是最稳妥的动态过滤实现方式，既不需要维护所有过滤组合，也无需依赖额外的SQL映射配置。

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