17370845950

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.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 解析**。