EF Core 9.0 中 ExecuteUpdate 方法迁移问题解析

在 EF Core 9.0 版本中，微软对批量更新和删除操作的 API 进行了重构，将原本位于 RelationalQueryableExtensions 类中的 ExecuteUpdate 和 ExecuteDelete 系列方法迁移到了 EntityFrameworkQueryableExtensions 类中。这一变更虽然保持了源代码级别的兼容性，但导致了二进制级别的破坏性变更。

变更背景

EF Core 团队将批量操作方法迁移到更基础的扩展类中，主要是为了支持非关系型数据库提供程序也能使用这些功能。这一设计决策体现了 EF Core 向多数据库类型支持方向的发展。

影响范围

这一变更主要影响以下场景：

1. 通过反射动态调用这些方法的代码
2. 使用 nameof() 操作符引用这些方法的代码
3. 在表达式树中硬编码引用原命名空间的代码

解决方案

对于受影响的代码，需要进行以下调整：

1. 将 using Microsoft.EntityFrameworkCore.RelationalQueryableExtensions 替换为 using Microsoft.EntityFrameworkCore.QueryableExtensions
2. 更新任何硬编码的类型引用，从 RelationalQueryableExtensions 改为 EntityFrameworkQueryableExtensions

高级场景：批量操作拦截器

许多开发者希望在执行批量更新操作时自动设置审计字段（如最后修改时间）。在 EF Core 中可以通过查询表达式树拦截器实现这一功能：

internal class ExecuteUpdateInterceptor : IQueryExpressionInterceptor
{
    public Expression QueryCompilationStarting(Expression queryExpression, QueryExpressionEventData eventData)
    {
        if (queryExpression is MethodCallExpression call &&
            call.Method.DeclaringType == typeof(EntityFrameworkQueryableExtensions) &&
            call.Method.Name == nameof(EntityFrameworkQueryableExtensions.ExecuteUpdate))
        {
            // 处理表达式树，添加审计字段设置逻辑
        }
        return queryExpression;
    }
}

注意事项

1. 对于 JSON 类型字段的批量更新，目前 EF Core 尚未提供原生支持
2. 在 EF Core 10 中，相关 API 可能还会有进一步调整
3. 调试时若遇到方法缺失问题，建议执行完整的项目清理和重建

这一变更虽然带来了短期的适配成本，但从长远看有助于 EF Core 支持更广泛的数据库类型，为开发者提供更一致的 API 体验。