.NET6中EF Core执行迁移时移除项目依赖致构建失败求助

问题复现场景 #

• 运行环境：.NET 6 + EF Core
• 初始表现：将Models/Entities实体类存放在独立文件夹时，执行首次迁移（Initial Migration）命令后，项目会自动移除部分关联依赖，直接导致构建失败；初期测试将实体类移动到项目根目录后执行相同迁移命令可正常运行
• 复测表现：后续验证发现，即便将实体类放在项目根目录执行迁移，仍会复现依赖被自动移除、构建失败的问题
• 参考信息：
  • 触发问题的项目文件夹结构：
  • 实际异常报错截图：

根因说明 #

该问题和实体类的存放路径没有本质关联，初期根目录执行成功属于本地编译缓存导致的偶发情况。核心触发原因是EF Core工具包版本与项目目标框架、EF Core运行时包版本不匹配，导致包管理器在执行迁移命令时触发了错误的依赖自动修正逻辑，误删了必要依赖。

修复步骤 #

1. 统一EF Core相关包版本
   卸载所有EF Core相关的预发布版本包，确保所有EF Core关联包版本完全一致，且为适配.NET 6的6.x稳定版（推荐使用6.0.25，即.NET 6生命周期内的最终稳定补丁版本），禁止在.NET 6项目中安装7.0/8.0等高版本EF Core包，大版本不兼容会直接触发工具链异常。
   必须安装的基础包清单：
   • Microsoft.EntityFrameworkCore
   • 对应数据库的EF Core提供程序（例如SQL Server用Microsoft.EntityFrameworkCore.SqlServer，MySQL用Pomelo.EntityFrameworkCore.MySql）
   • Microsoft.EntityFrameworkCore.Tools：该包必须安装在解决方案的启动项目中，不能仅在存放DbContext/实体的类库项目中安装
2. 清理本地编译缓存
   • 关闭所有打开的IDE、命令行终端
   • 删除解决方案根目录下的.vs隐藏文件夹，以及所有项目目录下的bin、obj文件夹
   • 重新打开解决方案，执行dotnet restore命令手动还原全量依赖
3. 修正迁移命令的执行目标
   • 使用包管理器控制台执行迁移时，先将控制台的「默认项目」选中为DbContext所在项目，将解决方案启动项目设置为安装了Microsoft.EntityFrameworkCore.Tools的项目
   • 使用CLI命令执行迁移时，显式指定项目路径，避免工具链识别错误，示例命令：

     dotnet ef migrations add Initial --project ./DataAccess --startup-project ./WebApi
     

4. 固定包引用避免被自动修改
   如果以上操作后仍出现依赖被自动移除的问题，直接编辑项目的.csproj文件，手动写入EF Core包引用，添加资产配置避免NuGet自动修改引用关系，示例配置：

   <ItemGroup>
     <PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.25" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="6.0.25" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="6.0.25">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
   </ItemGroup>
   

   修改保存后重新执行依赖还原即可。

验证提示：修复完成后可以先执行dotnet build确认项目可以正常编译，再执行迁移命令，避免再次触发异常依赖清理。

内容的提问来源于stack exchange，提问作者Viki