EF Core 9.0 在 NativeAOT 编译中的拦截器配置问题解析

在 .NET 生态系统中，Entity Framework Core (EF Core) 是一个广泛使用的对象关系映射框架。随着 .NET 9.0 的发布，开发者开始尝试将 EF Core 与 NativeAOT 编译结合使用，以追求更高的性能和更小的部署体积。然而，在这个过程中，不少开发者遇到了关于拦截器(Interceptors)配置的问题。

问题现象

当开发者尝试执行以下命令时：

dotnet ef dbcontext optimize --precompile-queries --nativeaot

或者进行 NativeAOT 发布时：

dotnet publish --ucr Test.Api/Test.Api.csproj -c Release -o ./app

系统会抛出编译错误，提示拦截器功能未在特定命名空间中启用。错误信息明确建议添加特定的 InterceptorsNamespaces 配置，但即使按照提示操作，问题依然存在。

问题根源

这个问题的本质在于 EF Core 9.0 与 Roslyn 编译器版本之间的兼容性问题。拦截器功能已经从预览状态毕业，相关的项目配置指令也从 <InterceptorsPreviewNamespaces> 更名为 <InterceptorsNamespaces>。然而，EF Core 9.0 的某些依赖项仍然引用了旧版本的编译器组件。

解决方案

经过社区验证，有以下两种解决方案：

方案一：升级相关编译器包

在项目文件中显式添加以下两个包的引用，并指定较新版本：

<PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.13.0" />
<PackageReference Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" Version="4.13.0" />

这两个包默认会被作为依赖项引入，但版本较旧(4.8.0)。手动指定新版本可以解决兼容性问题。

方案二：完整配置示例

以下是一个经过验证可用的完整项目配置示例：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <Nullable>enable</Nullable>
    <PublishAot>true</PublishAot>
    <InterceptorsNamespaces>$(InterceptorsNamespaces);Microsoft.EntityFrameworkCore.GeneratedInterceptors;Microsoft.Extensions.Configuration.Binder.SourceGeneration</InterceptorsNamespaces>
    <InterceptorsPreviewNamespaces>$(InterceptorsPreviewNamespaces);Microsoft.Extensions.Configuration.Binder.SourceGeneration</InterceptorsPreviewNamespaces>
    <Features>InterceptorsPreview</Features>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.4"/>
    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="9.0.4"/>
    <!-- 注意：可能需要移除或更新Tasks包 -->
  </ItemGroup>
</Project>

注意事项

1. Microsoft.EntityFrameworkCore.Tasks 包可能是问题的另一个潜在来源，建议暂时移除或更新该包。

2. EF Core 10 已经解决了这个问题，如果项目允许升级，可以考虑直接迁移到 EF Core 10。

3. 对于生产环境，建议在解决此问题后进行充分的测试，确保预编译查询和 NativeAOT 功能正常工作。

结论

EF Core 与 NativeAOT 的结合使用是提升应用性能的有效手段，但在当前版本中需要注意编译器版本的兼容性问题。通过显式指定较新的编译器包版本或采用完整的配置方案，开发者可以顺利解决拦截器相关的编译错误。随着 EF Core 的持续演进，这些问题有望在后续版本中得到根本解决。