部署IIS本地页面：Razor Pages应用发布后主页无法显示，如何解决？

• 确认ASP.NET Core托管捆绑包已安装
  服务器必须安装对应应用目标.NET版本的ASP.NET Core托管捆绑包，安装完成后重启IIS。未安装的话，IIS无法正确托管ASP.NET Core应用。

• 检查应用程序池配置

  • 将应用程序池的.NET CLR版本设置为无托管代码，ASP.NET Core应用不需要传统.NET Framework托管环境。
  • 确保应用程序池身份拥有站点物理路径的读取权限，推荐使用ApplicationPoolIdentity，并在文件管理器中给站点文件夹添加该身份的读取权限。

• 验证站点物理路径与发布文件完整性

  • 确认IIS站点的物理路径指向Razor Pages应用发布后的根目录（通常是项目bin目录下的Release发布文件夹）。
  • 检查发布文件是否完整：wwwroot静态资源、Pages页面文件夹、web.config配置文件必须存在，缺失关键文件会导致页面无法加载。

• 排查web.config配置问题
  确保web.config中的ASP.NET Core模块配置正确，示例配置如下（替换YourAppName.dll为实际应用程序集名称）：

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <location path="." inheritInChildApplications="false">
      <system.webServer>
        <handlers>
          <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
        </handlers>
        <aspNetCore processPath="dotnet" arguments=".\YourAppName.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
      </system.webServer>
    </location>
  </configuration>
  

  建议开启stdoutLogEnabled="true"，发布目录下会生成logs文件夹，里面的日志能直接显示应用启动时的错误信息。

• 启用IIS日志与失败请求跟踪

  • 开启站点的IIS日志，查看访问请求的状态码（如500内部错误、404资源不存在），初步定位问题类型。
  • 配置失败请求跟踪规则，捕获详细的请求处理过程日志，这是排查IIS托管应用问题的核心手段。

• 确认.NET运行时版本匹配
  在服务器命令行执行dotnet --list-runtimes，检查已安装的.NET运行时是否与应用的目标框架版本一致，版本不匹配会导致应用无法启动，进而返回空白页面。

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