MVC4网站迁移至新服务器报ViewBag不存在CS0103错误

核心报错说明 #

两层报错的逻辑非常明确：

• 顶层页面报错是因为自定义错误页本身也触发了异常，请求被直接终止，无法返回正常的错误提示
• 底层根本错误是视图编译失败：c:\inetpub\vhosts\ABCDomain.com\httpdocs\Views\Home\Index.cshtml (2): error CS0103: The name 'ViewBag' does not exist in the current context，这个错误的本质是Razor视图编译时没有继承MVC专属的WebViewPage基类——ViewBag是这个基类提供的动态属性，识别不到就说明视图解析的核心配置完全没有加载正确。

具体诱因（按出现概率排序） #

• Views目录专属web.config缺失：这是90%以上同类迁移问题的根因。MVC项目除了根目录的web.config，Views文件夹下必须存放独立的web.config文件，这个文件里定义了Razor视图的解析规则、默认基类、默认引入的命名空间、页面编译关联的程序集，是cshtml文件能被正确识别为MVC视图的核心配置。你提供的配置只有根目录内容，完全没涉及视图层的解析规则，IIS会把cshtml当成普通C#类文件编译，自然识别不到ViewBag、Html、Url这些MVC视图专属对象。同服务器其他MVC站点能正常运行，必然是因为它们的Views目录下存在这个配置文件。
• 根目录web.config配置错漏：
  • 版本不匹配：你标注项目是基于MVC4开发，但配置里的程序集绑定重定向全是高版本规则：System.Web.Mvc重定向到5.2.0.0（MVC5版本）、System.Web.WebPages/System.Web.Helpers重定向到3.0.0.0（对应MVC5配套的Razor3版本）。如果你站点bin目录下放的是MVC4版本的dll，版本不匹配会导致程序集加载失败，视图找不到对应的基类。
  • 节点重复：配置里存在两个独立的<system.webServer>节点，后一个节点仅配置了移除FormsAuthentication模块，会直接覆盖前一个节点的静态MIME配置、模块配置，不仅会导致woff/woff2字体加载异常，还会丢失MVC路由必需的托管模块配置，请求根本不会进入MVC处理管道。
  • 编译配置缺失：<system.web>下的<compilation>节点没有引入MVC相关的核心程序集引用，在Views配置缺失的场景下，IIS不会主动加载MVC相关dll参与视图编译。
• 临时编译目录权限不足：你在compilation节点中手动指定了视图临时编译目录C:\Inetpub\vhosts\ABCDomain.com\tmp，如果站点对应的应用程序池标识没有这个目录的读写、修改权限，视图预编译过程会因为无法写入临时文件、无法加载依赖程序集失败，同时自定义错误页本身也需要编译，就会触发顶层的“自定义错误页执行异常”报错。
• bin目录程序集部署不全：迁移站点时如果没有把MVC核心依赖dll（System.Web.Mvc、System.Web.Razor、System.Web.WebPages等）拷贝到站点bin目录，且服务器全局程序集缓存中没有对应版本的MVC程序集，就会导致视图编译时找不到依赖类型。

修复步骤 #

• 先从原服务器的完整站点备份中，找到Views文件夹下的web.config文件，原样拷贝到新服务器站点的对应Views目录，这一步完成后大部分同类问题会直接解决。
• 合并根web.config中两个重复的<system.webServer>节点，把静态资源配置、模块配置放到同一个节点下，补上MVC路由必需的托管模块配置。
• 核对bin目录下的MVC相关dll版本，和web.config中的绑定重定向规则对齐：如果保留MVC4版本，就把所有MVC、WebPages相关的绑定重定向版本改回MVC4对应的版本号；如果要升级到MVC5，就把bin目录下的相关dll全替换为和重定向规则匹配的版本。
• 给配置中指定的tmp临时目录授予站点应用程序池标识的读写、修改权限。
• 排查阶段临时将customErrors的mode属性设为Off，关闭自定义错误，直接查看完整的编译报错信息，确认问题修复后再重新开启自定义错误。

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