ASP.NET Core 8 MVC部署IIS启动失败，文件被当作静态资源下载

环境信息 #

• IIS版本：10.0
• 已安装.NET Hosting Bundle

web.config配置 #

<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\LSA.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" />
    </system.webServer>
  </location>
</configuration>

问题现象 #

• 应用启动失败，浏览器持续处于挂起状态
• IIS未执行应用逻辑，反而将文件作为静态资源提供下载
• 事件查看器提示系统尝试打开某个文件，但无法定位具体文件
• 修复发布包中缺失的.config扩展名后，出现403 Forbidden错误

已尝试的排查操作 #

1. 确认AspNetCoreModuleV2已在IIS处理程序映射中列出
2. 修改web.config的hostingModel为InProcess
3. 核对本地与服务器的IIS版本一致
4. 配置IIS应用文件夹的权限
5. 通过dotnet --info验证.NET Hosting Bundle已正确安装
6. 用SQL*Plus验证数据库凭证及连通性正常
7. 确认应用在本地IIS Express上可正常运行
8. 移除IIS中.dll对应的MIME类型

解决建议 #

1. 确认AspNetCoreModuleV2注册生效 #

打开IIS管理器，进入服务器节点的「模块」页面，确认AspNetCoreModuleV2存在。如果找不到，重新下载安装对应版本的.NET Hosting Bundle，安装完成后重启IIS和服务器，确保模块注册成功。

2. 修复处理程序映射优先级 #

检查站点的「处理程序映射」，确保aspNetCore规则（path="*"）的优先级高于静态文件处理规则。可以直接在站点级别重新添加aspNetCore处理程序映射，覆盖可能存在的继承规则。

3. 调整应用程序池配置 #

• 应用程序池的「.NET CLR版本」必须设置为无托管代码，ASP.NET Core应用不需要依赖IIS的托管CLR
• 给应用程序池标识（比如ApplicationPoolIdentity）添加应用文件夹的读取、执行、写入权限，尤其是logs文件夹需要写入权限来生成日志

4. 查看stdout日志定位启动问题 #

web.config已开启日志记录，检查应用目录下的logs文件夹是否生成了stdout日志文件。日志会详细记录应用启动失败的具体原因，比如依赖缺失、配置文件错误、数据库连接问题等。如果logs文件夹不存在，手动创建并赋予权限。

5. 解决403 Forbidden错误 #

出现403通常是权限或配置问题：

• 确认IIS_IUSRS和应用程序池标识对应用文件夹有读取权限
• 关闭站点的「目录浏览」功能（ASP.NET Core应用不需要目录浏览），同时检查默认文档设置是否匹配应用的默认路由（比如确保有index.html或控制器默认路由配置）

6. 验证发布包完整性 #

重新发布应用，若服务器上未部署对应版本的.NET Runtime，选择「独立部署」模式；若使用框架依赖部署，确认服务器已安装ASP.NET Core 8 Runtime。发布后检查所有必要文件是否齐全，包括.dll、.config、wwwroot目录及其中的静态资源。

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