EF Core 在.NET 9中IQueryable扩展方法作为子查询时的转换问题分析

问题背景

在从.NET 8升级到.NET 9后，开发人员发现一个原本正常工作的EF Core查询功能出现了异常。具体表现为：当在子查询中使用IQueryable的扩展方法时，这些方法无法被正确转换为SQL查询，导致运行时抛出异常。

问题现象

在复杂的LINQ查询中，特别是当扩展方法被用作Join操作的内部查询时，EF Core无法正确翻译这些扩展方法。错误信息表明查询无法被翻译，建议重写查询或显式切换到客户端评估。

技术分析

扩展方法的本质

IQueryable扩展方法本质上只是LINQ操作符的组合器。例如示例中的ExcludeDeleted方法实际上只是封装了一个Where条件：

internal static IQueryable<PointState> ExcludeDeleted(this IQueryable<PointState> queryable)
{
    return queryable.Where(p => p.DeletionState.State != DigitalTwinItemDeletionState.Deleted.State);
}

查询组合方式的影响

在.NET 8及以下版本中，以下查询形式可以正常工作：

var myResults = _myContext.Customers
    .Join(
        _myContext.Points
            .ExcludeDeleted()
            .ExcludePointsNotInUse(),
        customer => customerId,
        point => point.customerId,
        (customer, point) => new {customer, point});

但在.NET 9中，这种直接在Join内部使用扩展方法的写法会导致翻译失败。而将子查询提取到变量中则可以正常工作：

var pointsInUse = _myContext.Points
    .ExcludeDeleted()
    .ExcludePointsNotInUse();

var myResults = _myContext.Customers
    .Join(
        pointsInUse,
        customer => customerId,
        point => point.customerId,
        (customer, point) => new {customer, point});

潜在原因

虽然官方未能复现此问题，但从技术角度分析，可能的原因包括：

1. .NET 9中查询表达式树的解析逻辑发生了变化
2. 查询翻译器在处理嵌套表达式时的行为有所调整
3. 扩展方法在特定上下文中的解析方式发生了改变

解决方案建议

对于遇到类似问题的开发者，可以采取以下解决方案：

1. 查询分解：将包含扩展方法的子查询提取到单独的变量中
2. 内联扩展方法：直接将扩展方法内的逻辑写入主查询
3. 等待官方修复：如果确认是EF Core的bug，可以关注官方更新

总结

这个问题展示了EF Core在不同.NET版本间可能存在的行为差异。虽然简单的测试用例无法复现，但在复杂查询场景下确实可能遇到此类问题。开发者应当注意查询的组合方式，并在升级后进行全面测试，特别是对于包含自定义扩展方法的复杂查询。

对于需要保持代码整洁性的项目，查询分解（将子查询提取到变量）不仅解决了问题，还能提高代码的可读性，是一种值得推荐的实践方式。