EF Core 9.0 中关系型查询方法转换器的变更解析

背景介绍

在 Entity Framework Core 8.0 及之前版本中，开发者可以通过实现 IQueryableMethodTranslatingExpressionVisitorFactory 接口来自定义查询表达式的转换逻辑。一个常见的应用场景是处理枚举类型的字符串转换，例如在数据库中将枚举值存储为字符串而非整数。

技术变更点

EF Core 9.0 对查询转换机制进行了重要调整，主要体现在 RelationalQueryableMethodTranslatingExpressionVisitor 构造函数的参数类型变化：

• 8.0 版本：接受 QueryCompilationContext 类型参数
• 9.0 版本：改为接受 RelationalQueryCompilationContext 类型参数

这一变更反映了 EF Core 对关系型数据库查询处理的进一步专业化设计。RelationalQueryCompilationContext 是 QueryCompilationContext 的子类，专门为关系型数据库操作提供了额外的上下文信息。

迁移方案

对于需要从 EF Core 8.0 升级到 9.0 的项目，有以下两种处理方式：

1. 直接类型转换方案

在自定义工厂的 Create 方法中，可以将传入的 QueryCompilationContext 安全地转换为 RelationalQueryCompilationContext：

public QueryableMethodTranslatingExpressionVisitor Create(
    QueryCompilationContext queryCompilationContext)
{
    var relationalContext = (RelationalQueryCompilationContext)queryCompilationContext;
    return new StringEnumQueryableMethodTranslatingExpressionVisitor(
        this.dependencies,
        this.relationalDependencies,
        relationalContext, 
        new StringEnumExpressionVisitor());
}

这种方案简单直接，适用于需要快速迁移的场景。

2. 表达式树拦截方案（推荐）

EF Core 7.0 引入了更优雅的表达式树拦截机制，这比替换整个查询转换器更为轻量级：

public class StringEnumInterceptor : IQueryExpressionInterceptor
{
    public Expression QueryCompilationStarting(
        Expression queryExpression,
        QueryExpressionEventData eventData)
    {
        return new StringEnumExpressionVisitor().Visit(queryExpression);
    }
}

然后在 DbContext 配置中注册拦截器：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.AddInterceptors(new StringEnumInterceptor());
    // 其他配置...
}

表达式树拦截的优势在于：

• 处理范围更全面（不仅限于 Where 和 OrderBy）
• 不需要替换核心服务
• 实现更简洁
• 性能更好

技术建议

1. 枚举处理策略：对于枚举类型的处理，EF Core 本身已经内置了良好的支持。可以考虑直接使用 EF Core 的 ValueConverter 机制，而非自定义表达式转换。

2. 版本兼容性：如果项目需要同时支持多个 EF Core 版本，可以使用条件编译或运行时类型检查来处理不同版本的 API 差异。

3. 性能考量：表达式树拦截发生在查询编译的早期阶段，比查询方法转换器的介入点更靠前，通常具有更好的性能表现。

总结

EF Core 9.0 的这一变更体现了框架向更专业化方向发展的趋势。对于大多数场景，推荐采用表达式树拦截这种更现代、更轻量的方式来实现自定义查询处理逻辑。这种方案不仅解决了 API 变更带来的兼容性问题，还提供了更强大的功能和更好的性能表现。