ASP.NET Core MVC项目出现需引用System.Web.Mvc 5.0错误且找不到web.config求助

System.Web.Mvc 5.0.0.0是传统.NET Framework 平台下ASP.NET MVC的专属程序集，和ASP.NET Core的MVC实现完全不兼容。出现该报错本质是项目内残留了.NET Framework时代的旧依赖、迁移残留配置或错误引入了仅支持老框架的组件，并非需要手动添加该程序集到项目中。

• 定位旧依赖的触发源头
  • 检查项目目标框架：打开项目根目录的.csproj文件，确认<TargetFramework>节点值为netcoreapp3.1、net6.0、net7.0、net8.0等ASP.NET Core适配版本，避免错设为net4xx的.NET Framework兼容框架触发旧栈的依赖校验规则。
  • 排查NuGet包清单：检查所有已安装的NuGet依赖，卸载所有仅适配.NET Framework、依赖System.Web.Mvc的旧组件，这类组件包括老版本MvcPager、旧版第三方身份验证库、基于System.Web栈封装的通用工具类库，是触发该报错的最常见原因。
  • 全局清理项目残留配置：在项目根目录全局搜索关键词System.Web.Mvc、System.Web，删除从老ASP.NET Framework项目迁移时残留的旧web.config配置片段、web.config.transform文件、.csproj内引用老程序集的<Reference>节点。如果直接搜索项目文件找不到匹配内容，基本可以判断是NuGet依赖间接拉取的旧程序集引用。
• 修正错误的代码与依赖匹配关系
  • 不要直接手动安装对应版本的System.Web.Mvc NuGet包，该操作会将整套System.Web旧栈引入ASP.NET Core项目，触发更多不可预期的运行时错误。正确处理方式是将拉取旧依赖的第三方组件替换为官方适配ASP.NET Core的版本，例如老版MvcPager替换为对应AspNetCore版本的MvcPager组件，旧版System.Web身份验证库替换为Microsoft.AspNetCore.Authentication系列官方包。
  • 逐文件检查代码的命名空间引用：将所有写有using System.Web.Mvc;的代码行，替换为ASP.NET Core对应的using Microsoft.AspNetCore.Mvc;——两个MVC框架的类结构无向下兼容映射，保留旧命名空间引用会持续触发程序集校验报错。
• 验证编译状态
  • 清空本地NuGet残留缓存：在项目根目录执行dotnet nuget locals all --clear清理旧包残留，再执行dotnet restore拉取适配Core框架的正确依赖版本，最后执行dotnet build验证编译结果。
  • 若报错仍存在，打开项目obj目录下的project.assets.json文件，全局搜索System.Web.Mvc定位具体拉取旧程序集的依赖节点，在NuGet包管理界面直接卸载对应依赖即可。

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