EF Core 中动态构建
Where查询条件,核心是利用 表达式树(Expression Tree) 拼接条件,而不是字符串拼接或 if-else 堆砌。直接用
Where(x => true)起手,再根据参数是否有效逐步
.Where()链式追加,是最简单、安全、可读性高的做法。
基础写法:链式 Where 追加条件
适用于大多数场景,逻辑清晰,SQL 生成高效,且支持 EF Core 的延迟执行和跟踪行为。
每个.Where()调用都会合并为一个 SQL
AND条件(EF Core 自动优化) 空值或默认值判断放在 C# 端,不传入数据库,避免无效条件影响性能 示例:按姓名、状态、创建时间范围查询用户
IQueryable<User> query = context.Users.AsQueryable(); <p>if (!string.IsNullOrWhiteSpace(name)) query = query.Where(u => u.Name.Contains(name));</p><p>if (status.HasValue) query = query.Where(u => u.Status == status.Value);</p><p>if (startTime != null) query = query.Where(u => u.CreatedTime >= startTime.Value);</p><p>if (endTime != null) query = query.Where(u => u.CreatedTime <= endTime.Value);</p><p>var users = await query.ToListAsync();
进阶写法:用 Expression 构建动态条件(适合复杂复用)
当条件逻辑非常灵活(如多字段模糊搜索、自定义运算符、运行时字段名),需要手动拼表达式树。推荐封装成扩展方法,避免重复造轮子。
用Expression.Parameter定义参数变量 用
Expression.Property和
Expression.Constant构建访问和值 用
Expression.AndAlso或
Expression.OrElse合并条件 最后用
Expression.Lambda转成
Expression<func bool>></func>
public static Expression<Func<T, bool>> BuildContainsExpression<T>(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<Func<T, bool>>(body, param);
}
<p>// 使用
if (!string.IsNullOrEmpty(keyword))
{
var expr = BuildContainsExpression<User>("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<t></t>,提升可测试性和复用性(比如 AdminSpec、ActiveUserSpec、SearchByNameSpec)。 每个 Specification 实现
Expression<func bool>> Criteria { get; }</func>
支持 And()/
Or()组合多个条件 配合仓储层使用,业务代码只关心“要什么”,不关心“怎么查”
基本上就这些。链式 Where 是首选,够用又稳;真有复杂动态需求,再上 Expression 封装或 Specification。不复杂但容易忽略的是:**所有条件判断必须在 ToListAsync() 之前完成,且确保最终 IQueryable 仍由 EF Core 解析**。
