IIS 8.5部署ASP.NET MVC5忽略MVC映射仅加载静态资源问题

按以下优先级逐一排查，直接复制发布文件的场景下90%以上的问题都能定位解决：

• 检查IIS应用程序开发角色安装状态
  打开服务器管理器→添加角色和功能→Web服务器(IIS)→应用程序开发节点，勾选和你项目.NET Framework版本匹配的ASP.NET组件（比如项目基于.NET Framework 4.7/4.8就选ASP.NET 4.8）、.NET Extensibility组件，不要只安装静态文件服务。安装完成后执行iisreset重启IIS服务。漏装该组件时IIS不会加载托管代码模块，所有MVC路由请求都会被当作静态文件路径处理，自然匹配不到资源。
• 校验应用程序池配置
  打开IIS管理器找到站点对应应用程序池：
  • .NET CLR版本选择v4.0（所有.NET Framework 4.x版本的项目都选这个，不要选v2.0，也不要选“无托管代码”）
  • 托管管道模式设置为集成模式，经典模式下UrlRoutingModule需要额外手动做通配符映射，配置不当很容易失效
• 核对站点web.config的模块、处理程序映射
  打开站点根目录下的web.config，确认<system.webServer>节点下存在无后缀URL处理程序和路由模块的正确配置，缺失的话直接补全：

<system.webServer>
  <validation validateIntegratedModeConfiguration="false" />
  <modules>
    <remove name="UrlRoutingModule-4.0" />
    <add name="UrlRoutingModule-4.0" type="System.Web.Routing.UrlRoutingModule" preCondition="managedHandler,runtimeVersionv4.0" />
  </modules>
  <handlers>
    <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
    <remove name="OPTIONSVerbHandler" />
    <remove name="TRACEVerbHandler" />
    <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
  </handlers>
</system.webServer>

注意配置前先remove同名项，避免重复注册导致IIS启动报错。

• 检查部署文件完整性
  手动复制发布文件很容易漏传根目录文件和依赖：
  • 确认站点根目录存在Global.asax文件，你贴的文件内容配置是正确的，但如果漏传这个文件，MVC的路由注册入口根本不会执行
  • 确认bin目录下存在System.Web.Mvc、System.Web.Routing、System.Web.WebPages等核心MVC依赖dll，如果项目是用VS发布的，直接把整个发布输出目录的所有内容全选复制，不要手动挑文件夹拷贝
• 配置目录权限
  给站点根目录分配IIS_IUSRS用户组的读取、执行权限，权限不足时bin目录下的程序集、Global.asax都无法被加载，MVC初始化逻辑不会运行。
• 本地验证排查
  所有配置修改完成后，先在服务器本地用localhost绑定的地址访问站点，不要直接从外部客户端访问，排除防火墙、前置代理的拦截问题。如果本地访问仍返回404，可以开启IIS的失败请求跟踪功能，查看请求是被静态文件模块拦截，还是根本没进入托管处理管道，进一步定位问题。

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