部署在IIS中的Blazor应用无法渲染页面求助

以下是针对该问题的具体排查和解决步骤：

1. 确认SignalR连接状态 #

Blazor Server依赖SignalR通信，即便浏览器控制台无报错，也可手动检查连接：

• 打开浏览器控制台，执行：

  Blazor.defaultReconnectionHandler._connection.state
  

  若返回值不是Connected，需做以下检查：
  • 进入IIS站点的功能视图，确保WebSocket协议已启用
  • 确认服务器防火墙/安全组未拦截WebSocket流量（默认与HTTP端口共用）

2. 核对应用池核心配置 #

确保应用池配置符合要求：

• 托管管道模式设置为集成
• .NET CLR版本选择无托管代码
• 临时将应用池标识改为LocalSystem，排除权限不足导致的启动失败

3. 检查发布目录权限 #

• 确认IIS应用池对应的标识对发布文件夹拥有读取和执行权限
• 可临时给Everyone添加读取权限进行测试，排除权限问题

4. 修正_base href路径 #

若站点部署在子路径（如http://yourdomain/blazorapp）：

• 修改发布包中wwwroot/index.html的<base href="/" />为<base href="/blazorapp/" />
• 同时在Program.cs中添加路径配置：

  app.UsePathBase("/blazorapp");
  

5. 启用详细日志定位问题 #

在appsettings.json中添加日志配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Debug",
      "Microsoft.AspNetCore.SignalR": "Debug"
    }
  }
}

重启站点后，查看IIS日志或自定义日志文件，获取启动和连接过程中的详细错误信息

6. 匹配Hosting Bundle版本 #

确保远程服务器安装的.NET Hosting Bundle版本与开发环境使用的.NET SDK版本完全一致，版本不匹配可能导致运行时异常

7. 测试独立运行应用 #

在远程服务器的发布目录中，直接执行：

dotnet YourApplication.dll

然后访问http://localhost:5000，若能正常显示，说明问题出在IIS配置；若仍空白，需重新发布应用并选择独立部署模式

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