WebAPI发布至IIS 7.5后Application_Start未执行且报404错误求助

碰到这种本地IIS Express正常、发布到IIS就出问题的情况，大概率是IIS配置或部署环节踩坑了，我给你梳理几个最实用的排查方向，一步步来定位：

• 先检查应用程序池的核心配置
  这是最常见的问题根源：

  • 确认应用程序池的*.NET框架版本*和你的WebAPI项目匹配——你用VS2015开发，项目应该是基于.NET 4.x的，所以池要选.NET Framework v4.0.x，绝对不能选“无托管代码”或者更低的版本，不然ASP.NET根本没法初始化。
  • 托管管道模式要设为集成模式，经典模式下WebAPI的路由规则会失效，不仅会报404，还会影响Application_Start的触发。

• 验证站点物理路径与权限

  • 先确认IIS站点指向的物理路径是你发布后的正确文件夹，别不小心指向了项目源码目录或者空文件夹。
  • 给应用程序池的身份（比如IIS AppPool\你的池名称）赋予物理路径的读取+执行权限，权限不足会导致ASP.NET无法加载应用，Application_Start自然不会执行。

• 检查Web.config的关键配置

  • 确认路由模块是否正确注册：WebAPI依赖UrlRoutingModule，如果<system.webServer>节点下缺失相关配置，路由无法解析会直接返回404。可以添加或检查这段配置：

    <modules runAllManagedModulesForAllRequests="true">
      <remove name="UrlRoutingModule-4.0" />
      <add name="UrlRoutingModule-4.0" type="System.Web.Routing.UrlRoutingModule" preCondition="" />
    </modules>
    

  • 暂时关闭自定义错误：如果Web.config里<customErrors mode="On">，会把Application_Start里抛出的异常屏蔽成404页面，改成<customErrors mode="Off">就能看到真实的错误信息了。

• 确认ASP.NET已正确注册到IIS
  有时候IIS没有和.NET框架绑定，导致无法托管ASP.NET应用。以管理员身份打开命令提示符，运行对应版本的注册命令：

  C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
  

  执行完成后重启IIS，再测试站点。

• 查看日志找细节

  • 去IIS站点的日志里看详细记录，日志里的404子状态（比如404.17表示动态内容无法处理）能帮你精准定位问题。
  • 打开Windows事件查看器，查看「Windows日志」→「应用程序」里的错误记录，ASP.NET初始化失败的话，这里会有详细的异常堆栈，比页面上的404有用得多。

• 检查发布包完整性
  对比本地运行的项目和IIS上的发布文件，确保bin文件夹里包含所有依赖DLL——包括Logic项目、EF Repository项目的输出DLL，如果缺少关键依赖，ASP.NET初始化会失败，Application_Start也不会触发。

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