.NET6项目降级至.NET5时NuGet包无法降级的问题

问题背景 #

把项目的目标框架从net6.0改成net5.0：

<TargetFramework>net5.0</TargetFramework>

之后出现了一堆预期内的包兼容性错误，比如：

Package Microsoft.EntityFrameworkCore.Tools 6.0.5 is not compatible with net5.0 (.NETCoreApp,Version=v5.0). Package Microsoft.EntityFrameworkCore.Tools 6.0.5 supports: net6.0 (.NETCoreApp,Version=v6.0)

但单独降级某个包的时候（比如执行Install-Package Microsoft.EntityFrameworkCore.Tools -Version 5.0.17），会触发其他依赖包的兼容性报错，导致包操作回滚，无法完成降级。错误示例如下：

Install-Package : NU1202: Package Abp.AspNetCore.SignalR 7.2.1 is not compatible with net5.0 (.NETCoreApp,Version=v5.0). Package Abp.AspNetCore.SignalR 7.2.1 supports: net6.0 
(.NETCoreApp,Version=v6.0)
At line:1 char:1
+ Install-Package Microsoft.EntityFrameworkCore.Design -Version 5.0.17
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Install-Package], Exception
    + FullyQualifiedErrorId : NuGetCmdletUnhandledException,NuGet.PackageManagement.PowerShellCmdlets.InstallPackageCommand

Install-Package : NU1202: Package Microsoft.AspNetCore.Authentication.JwtBearer 6.0.5 is not compatible with net5.0 (.NETCoreApp,Version=v5.0). Package 
Microsoft.AspNetCore.Authentication.JwtBearer 6.0.5 supports: net6.0 (.NETCoreApp,Version=v6.0)
...
Install-Package : Package restore failed. Rolling back package changes for 'ATC.Web.Host'.

解决方案 #

1. 直接编辑csproj文件统一修改版本 #

这是最省心的方式，绕过NuGet逐个处理的依赖冲突：

• 右键项目 → 选择「编辑项目文件」打开csproj
• 找到所有引用的包，把.NET 6版本的包统一替换成.NET 5兼容的版本：
  • 微软官方包（比如EF Core系列）：把6.0.x改成5.0.17（这是5.x的最终稳定版）
  • 第三方包：
    • Abp.AspNetCore.SignalR：Abp 7.x只支持.NET 6+，要换成支持net5的Abp 5.x版本（比如5.3.0）
    • Owl.reCAPTCHA：查它的NuGet历史版本，找支持net5的（比如0.4.0）
• 保存文件后，右键项目 → 「还原NuGet包」

示例修改后的csproj片段：

<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.17">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>
<PackageReference Include="Abp.AspNetCore.SignalR" Version="5.3.0" />
<PackageReference Include="Owl.reCAPTCHA" Version="0.4.0" />

2. 用包管理器控制台批量降级 #

可以一次性指定多个包和对应版本，强制统一降级：

Install-Package Microsoft.EntityFrameworkCore -Version 5.0.17; 
Install-Package Microsoft.EntityFrameworkCore.SqlServer -Version 5.0.17; 
Install-Package Microsoft.EntityFrameworkCore.Tools -Version 5.0.17; 
Install-Package Microsoft.AspNetCore.Authentication.JwtBearer -Version 5.0.17;
Install-Package Abp.AspNetCore.SignalR -Version 5.3.0;
Install-Package Owl.reCAPTCHA -Version 0.4.0

注意：要提前确认每个第三方包的兼容版本，把它们加入命令中。

3. 清理后重新还原 #

如果修改后还是有冲突，试试彻底清理再还原：

• 删除项目下的obj和bin文件夹
• 删除解决方案根目录的packages文件夹（如果用的是packages.config）
• 在包管理器控制台执行：

  Update-Package -Reinstall
  

  这会重新安装所有包，适配当前的net5.0框架

关键提醒 #

• 第三方包必须找明确支持net5.0的版本，不能只降级微软官方包
• 同一生态的包版本要统一（比如EF Core的所有相关包必须用同一个5.x版本）
• 改完后一定要编译测试，因为.NET 6到5有API差异，可能存在代码层面的兼容性问题

内容的提问来源于stack exchange，提问作者Osama El-Masri