EF Core Where查询条件怎么写 EF Core动态构建查询条件方法

EF Core 动态构建 Where 条件首选链式 Where 追加,安全高效;复杂场景可用 Expression 树封装或 Specification 模式;严禁字符串拼接、反射调用或提前 ToList。

EF Core 中动态构建 Where 查询条件,核心是利用 表达式树(Expression Tree) 拼接条件,而不是字符串拼接或 if-else 堆砌。直接用 Where(x => true) 起手,再根据参数是否有效逐步 .Where() 链式追加,是最简单、安全、可读性高的做法。

基础写法:链式 Where 追加条件

适用于大多数场景,逻辑清晰,SQL 生成高效,且支持 EF Core 的延迟执行和跟踪行为。

  • 每个 .Where() 调用都会合并为一个 SQL AND 条件(EF Core 自动优化)
  • 空值或默认值判断放在 C# 端,不传入数据库,避免无效条件影响性能
  • 示例:按姓名、状态、创建时间范围查询用户
IQueryable query = context.Users.AsQueryable();

if (!string.IsNullOrWhiteSpace(name)) query = query.Where(u => u.Name.Contains(name));

if (status.HasValue) query = query.Where(u => u.Status == status.Value);

if (startTime != null) query = query.Where(u => u.CreatedTime >= startTime.Value);

if (endTime != null) query = query.Where(u => u.CreatedTime <= endTime.Value);

var users = await query.ToListAsync();

进阶写法:用 Expression 构建动态条件(适合复杂复用)

当条件逻辑非常灵活(如多字段模糊搜索、自定义运算符、运行时字段名),需要手动拼表达式树。推荐封装成扩展方法,避免重复造轮子。

  • Expression.Parameter 定义参数变量
  • Expression.PropertyExpression.Constant 构建访问和值
  • Expression.AndAlsoExpression.OrElse 合并条件
  • 最后用 Expression.Lambda 转成 Expression>
public static Expression> BuildContainsExpression(string propertyName, string value)
{
    var param = Expression.Parameter(typeof(T), "x");
    var prop = Expression.Property(param, propertyName);
    var method = typeof(string).GetMethod("Contains", new[] { typeof(string) });
    var body = Expression.Call(prop, method, Expression.Constant(value));
    return Expression.Lambda>(body, param);
}

// 使用 if (!string.IsNullOrEmpty(keyword)) { var expr = BuildContainsExpression("Name", keyword); query = query.Where(expr); }

注意避坑:别用字符串拼接或反射调用 Where

以下写法看似“动态”,但实际有问题:

  • query.Where("Name.Contains(@0)", keyword) —— 这是 EF6 的旧语法,EF Core 不支持,会报错
  • typeof(QueryExtensions).GetMethod("Where") 反射调用 —— 类型擦除、难调试、易出错,且无法被 EF Core 正确翻译
  • ToList() 再 Linq to Objects 过滤 —— 数据全拉到内存,丧失分页、索引优势,大数据量直接崩

实用技巧:结合 Specification 模式统一管理查询逻辑

把常见查询条件封装成可组合的 ISpecification,提升可测试性和复用性(比如 AdminSpec、ActiveUserSpec、SearchByNameSpec)。

  • 每个 Specification 实现 Expression> Criteria { get; }
  • 支持 And() / Or() 组合多个条件
  • 配合仓储层使用,业务代码只关心“要什么”,不关心“怎么查”

基本上就这些。链式 Where 是首选,够用又稳;真有复杂动态需求,再上 Expression 封装或 Specification。不复杂但容易忽略的是:**所有条件判断必须在 ToListAsync() 之前完成,且确保最终 IQueryable 仍由 EF Core 解析**。