IQueryable扩展方法中Where为何表现为IEnumerable而非IQueryable？

我实现了一个IQueryable类型的WhereIf扩展方法，用于Entity Framework链式查询，仅在满足前置条件时应用过滤，但遇到两个问题：

• 方法里的.Where()被识别为IEnumerable类型，引发运行时异常，必须用.AsQueryable()才能临时解决；
• 调用该方法时抛出异常：The source 'IQueryable' doesn't implement 'IAsyncEnumerable<Model>'. Only sources that implement 'IAsyncEnumerable' can be used for Entity Framework asynchronous operations.，目前还没解决。

但另一个针对Game类型的非泛型FilterGames扩展方法中，.Where()被正确识别为IQueryable类型且正常工作，请问这两种情况为什么会有差异？

代码示例 #

代码1：WhereIf扩展方法 #

public static class WhereIfHelper
{
    public static IQueryable<T> WhereIf<T>(this IQueryable<T> source, bool condition, Func<T, bool> expression)
        where T: class
    {
        return condition ? source.Where(expression) : source;
    }
}

代码2：FilterGames扩展方法 #

public static class RepositoryIssueExtensions
{
    public static IQueryable<Game> FilterGames(this IQueryable<Game> games,
    DateTimeOffset initialDate,
    DateTimeOffset lastDate) => games.Where(i => i.CreatedAt >= initialDate && i.CreatedAt <= lastDate);
}

核心差异：Where方法的重载选择 #

问题根源在于编译器对Where方法的重载匹配逻辑：

• 代码2中，games.Where(i => ...)调用的是Queryable.Where（IQueryable<T>的扩展方法），因为编译器自动将lambda表达式转换为Expression<Func<T, bool>>类型（表达式树），返回的是EF可识别的IQueryable<Game>，能被解析为SQL执行，且支持异步操作。
• 代码1中，参数expression的类型是Func<T, bool>（委托），编译器会匹配Enumerable.Where（IEnumerable<T>的扩展方法），返回的是IEnumerable<T>。即使你将结果强转为IQueryable<T>返回，这个对象本质是LINQ to Objects的枚举器，已脱离EF的查询树管理，既会触发内存枚举引发异常，也不支持IAsyncEnumerable，导致异步操作报错。

解决步骤 #

1. 修改WhereIf的参数类型 #

将Func<T, bool>改为Expression<Func<T, bool>>，让编译器选择Queryable.Where重载：

public static class WhereIfHelper
{
    public static IQueryable<T> WhereIf<T>(this IQueryable<T> source, bool condition, Expression<Func<T, bool>> expression)
        where T: class
    {
        return condition ? source.Where(expression) : source;
    }
}

修改后，返回的仍是EF原生的IQueryable<T>，既保留查询树可被解析为SQL，也天然支持IAsyncEnumerable，能正常使用EF的异步方法（如ToListAsync）。

2. 代码2正常工作的原因 #

代码2中的lambda表达式，因FilterGames方法返回IQueryable<Game>，编译器会自动将lambda编译为表达式树而非委托，匹配Queryable.Where的参数要求，因此返回的IQueryable是EF可识别的类型，自然能正常工作。

3. 异步异常的本质 #

当你用Func<T, bool>调用Where后，返回的IEnumerable<T>即使通过AsQueryable()转为IQueryable，其底层实现是LINQ to Objects的EnumerableQuery，并未实现IAsyncEnumerable接口。而EF的异步方法要求源必须实现该接口，因此抛出异常。修改参数为表达式树后，返回的是EF的DbSet或DbQuery派生类型，天然支持IAsyncEnumerable，异步操作即可正常执行。

内容的提问来源于stack exchange，提问作者Yuri Soares