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# 端，不传入数据库，避免无效条件影响性能
- 示例：按姓名、状态、创建时间范围查询用户
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 解析**。
