EF Core 9.0 设计包缺失问题解析与解决方案

在.NET 9.0环境下使用EF Core进行开发时，开发者可能会遇到一个常见问题：当尝试运行脚手架命令生成代码时，系统提示无法加载Microsoft.EntityFrameworkCore.Design程序集。这个问题主要出现在.NET SDK 9.0.200版本中，是由SDK的一个破坏性变更引起的。

问题现象

当开发者执行类似以下的脚手架命令时：

dotnet aspnet-codegenerator blazor CRUD -dbProvider sqlite -dc BlazorWebAppMovies.Data.BlazorWebAppMoviesContext -m Movie -outDir Components/Pages

系统会抛出如下错误：

Could not load file or assembly 'Microsoft.EntityFrameworkCore.Design, Version=9.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified.

问题根源

这个问题源于.NET SDK 9.0.200版本中的一个变更，该变更影响了设计时工具包的加载方式。Microsoft.EntityFrameworkCore.Design包通常被标记为仅用于工具，不应该直接包含在应用程序中。但在某些情况下，特别是使用脚手架工具时，这个包需要被正确加载。

解决方案

目前有以下几种解决方案：

1. 最佳临时解决方案：修改项目文件中的包引用配置

<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.2">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  <Publish>true</Publish>
</PackageReference>

2. 环境变量解决方案：设置DOTNET_ROLL_FORWARD环境变量

export DOTNET_ROLL_FORWARD=Major

3. 简化包引用方案（不推荐长期使用）：

<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.2" />

注意事项

• 这个问题预计在.NET SDK后续版本中会被修复
• 使用简化包引用方案虽然能解决问题，但不是最佳实践，因为它会改变包的默认行为
• 对于生产环境，建议采用第一种解决方案，它既解决了问题又保持了最佳实践

深入理解

Microsoft.EntityFrameworkCore.Design包包含EF Core的设计时功能，这些功能在开发过程中用于生成代码、执行迁移等操作。在正常情况下，这个包不应该被包含在发布的应用程序中，因此默认配置会将其标记为私有资产。

脚手架工具在运行时需要访问这些设计时功能，因此需要确保包能够被正确加载。添加<Publish>true</Publish>配置允许包在开发时被正确加载，同时仍保持其在发布时的私有性。

这个问题提醒我们，在使用工具链时，理解各组件之间的依赖关系非常重要。当遇到类似问题时，检查包的引用配置通常是解决问题的第一步。