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

EF Core 中动态构建 Where 查询条件,核心是利用 表达式树(Expression Tree) 拼接条件,而不是字符串拼接或 if-else 堆砌。直接用 Where(x => true) 起手,再根据参数是否有效逐步 .Where() 链式追加,是最简单、安全、可读性高的做法。
基础写法:链式 Where 追加条件
适用于大多数场景,逻辑清晰,SQL 生成高效,且支持 EF Core 的延迟执行和跟踪行为。
- 每个
.Where()调用都会合并为一个 SQLAND条件(EF Core 自动优化) - 空值或默认值判断放在 C# 端,不传入数据库,避免无效条件影响性能
- 示例:按姓名、状态、创建时间范围查询用户
IQueryablequery = 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.Property和Expression.Constant构建访问和值 - 用
Expression.AndAlso或Expression.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 解析**。










