旧MVC（.aspx视图）项目运行报错：无法加载指定版本Razor组件

我之前在维护旧MVC项目时也碰到过一模一样的版本冲突问题，给你几个针对性的解决方案，一步步来排查应该能解决：

1. 检查并修正所有Web.config的版本配置 #

很多人只改了根目录的web.config，但Views文件夹下的web.config才是Razor视图真正读取配置的地方，这是最容易忽略的点：

• 打开根目录的web.config，找到<runtime>节点下的<assemblyBinding>，确保System.Web.WebPages.Razor的绑定规则覆盖旧版本并指向你安装的2.0.0.0：

<dependentAssembly>
  <assemblyIdentity name="System.Web.WebPages.Razor" publicKeyToken="31bf3856ad364e35" />
  <bindingRedirect oldVersion="0.0.0.0-2.0.0.0" newVersion="2.0.0.0" />
</dependentAssembly>

• 接着打开Views/web.config，找到<system.web.webPages.razor>节点，把相关版本属性改成2.0.0.0，同时检查<compilation>下的assemblies引用：

<!-- 确保host节点的版本匹配你的MVC版本，这里以MVC4为例 -->
<host factoryType="System.Web.Mvc.MvcWebRazorHostFactory, System.Web.Mvc, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
<!-- 检查compilation里的引用版本 -->
<compilation>
  <assemblies>
    <add assembly="System.Web.WebPages.Razor, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
  </assemblies>
</compilation>

2. 用正确的NuGet包重新安装依赖 #

你说找不到asp.net.webpage组件？是包名不对，正确的NuGet包名称是Microsoft.AspNet.WebPages。按以下步骤操作：

• 打开NuGet包管理器控制台，先卸载已有的相关包（避免版本残留）：

Uninstall-Package Microsoft.AspNet.WebPages -Force
Uninstall-Package Microsoft.AspNet.Razor -Force

• 然后安装对应2.0.0.0版本的包（WebPages 2.0对应Razor 2.0，这里用稳定的2.0.30506.0版本）：

Install-Package Microsoft.AspNet.WebPages -Version 2.0.30506.0
Install-Package Microsoft.AspNet.Razor -Version 2.0.30506.0

• 安装完成后，右键项目选择「清理」，再重新生成项目，确保没有编译错误。

3. 检查项目引用的细节 #

• 右键项目 → 「引用」，找到System.Web.WebPages.Razor，查看属性：确认「版本」是2.0.0.0，「复制本地」设置为True（这样dll会被复制到bin目录，避免找不到）。
• 如果引用的dll路径不对（比如指向了GAC里的旧版本），可以先删除这个引用，然后手动从NuGet包目录（通常在你的项目根目录/packages/Microsoft.AspNet.Razor.2.0.30506.0/lib/net40）添加System.Web.WebPages.Razor.dll的引用。

4. 清理缓存和临时文件 #

有时候缓存会导致旧版本残留，按以下步骤清理：

• 手动删除项目根目录下的bin和obj文件夹，彻底清除编译生成的文件。
• 清理IIS Express的临时文件：路径一般是C:\Users\[你的用户名]\AppData\Local\Temp\Temporary ASP.NET Files，找到对应项目的文件夹删除。
• 重启Visual Studio，重新生成项目。

如果以上步骤都试过还是不行，可以打开项目的.csproj文件，搜索System.Web.WebPages.Razor，确保所有相关的引用条目都是2.0.0.0版本，没有残留的1.0.0.0引用。

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