未使用MVC的WebForms项目为何提示加载System.Web.Razor报错?
报错核心原因
这个报错本质是测试服务器环境加载的System.Web.Razor程序集版本,和项目预期依赖的版本不匹配,和你有没有显式引用System.Web.Mvc没有必然联系,常见诱因有三类:
- 开发与测试环境运行时不一致:你的开发设备上安装了高版本.NET Framework、或ASP.NET Web Pages运行时,自带对应版本的System.Web.Razor组件,所以本地运行正常;而测试服务器的.NET Framework版本更低,也没有安装额外的ASP.NET Web Pages运行时,无法找到对应版本的程序集。
- 存在隐式依赖引用:就算你没有手动引用System.Web.Razor,也可能有其他场景触发加载:
- 项目中安装的第三方NuGet包间接依赖了System.Web.Razor
- web.config的
<compilation>节点下的<assemblies>列表中,默认或误加了System.Web.Razor的引用配置 - 项目中用到了依赖Razor的功能,比如动态页面生成、内置的轻量视图渲染逻辑
- 部署配置错误:
- 项目中System.Web.Razor引用的「复制本地」属性设为False,部署时没有把对应dll打包到站点bin目录
- 本地web.config里配置了System.Web.Razor的程序集绑定重定向,但部署时没有同步更新服务器上的web.config,导致版本匹配失败
快速排查步骤
- 打开项目的web.config,检查
<runtime><assemblyBinding>节点下是否有System.Web.Razor的绑定重定向配置,确保版本范围正确,且部署时同步该配置到测试服务器 - 在NuGet包管理器控制台执行
Get-Package -ProjectName <你的项目名> | Get-PackageDependency,查看是否有依赖System.Web.Razor的包,找到后将对应System.Web.Razor引用的「复制本地」属性改为True - 确认测试服务器安装的.NET Framework版本与开发环境一致,若无法升级服务器版本,可将本地对应版本的System.Web.Razor.dll手动复制到站点bin目录下
内容的提问来源于stack exchange,提问作者Steve Cross
相关产品推荐
相关产品推荐

