将基于.NET Framework的ASP.NET Core项目迁移至.NET Core 3.1.X遇依赖问题求解决方案

1. 先清缓存再重新还原 #

• 直接删掉项目目录下的bin和obj文件夹，把旧编译产物和缓存清干净
• 打开命令行执行dotnet restore，让NuGet重新适配.NET Core 3.1的依赖链条

2. 替换.NET Framework专属依赖包 #

• 逐个排查项目中的依赖，将仅支持.NET Framework的包替换为兼容.NET Core的版本：
  • 比如System.Web相关包直接换成Microsoft.AspNetCore.*对应组件
  • 第三方库优先选择标注支持netcoreapp3.1或.NETStandard 2.0+的版本
• 不确定兼容性时，查看NuGet包详情的Dependencies部分即可确认

3. 强制解决版本冲突 #

• 打开.csproj文件，给冲突的包添加VersionOverride属性锁死兼容版本：

  <PackageReference Include="Newtonsoft.Json" Version="12.0.3">
    <VersionOverride>12.0.3</VersionOverride>
  </PackageReference>
  

• 执行dotnet list package --outdated命令列出所有过时包，逐个升级到.NET Core 3.1支持的最新稳定版

4. 借助迁移工具简化操作 #

• 先安装迁移工具：dotnet tool install -g dotnet-aspnet-codegenerator，再执行dotnet aspnet-codegenerator migrate，工具会自动检测并修复部分依赖适配问题
• 使用Visual Studio的话，右键项目→迁移→迁移到.NET Core，工具会提供可视化的修复建议

5. 移除无效依赖与配置 #

• 删除项目中未实际使用的依赖包，降低冲突概率
• 检查web.config，移除.NET Framework专属的配置节（比如system.web下的内容），避免加载无效依赖

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