Blazor Server应用在Windows Server 2016（IIS10）出现空引用异常求助

针对你在Windows Server 2016（IIS v10）上运行Blazor Server应用时遇到的空引用异常，结合你的组件代码和环境差异，提供以下排查方向和修复方案：

1. 组件代码添加空值防护 #

你的TopMenuBar组件中直接访问ContextAccessor.HttpContext，但在Blazor Server的某些场景下（如预渲染阶段、IIS上下文未正确初始化时），HttpContext可能为null。先添加空值检查避免异常：

protected override async Task OnInitializedAsync()
{
    // 先判断HttpContext是否存在
    var httpContext = ContextAccessor.HttpContext;
    if (httpContext != null)
    {
        FullName = httpContext.User.Claims.FirstOrDefault(c => c.Type == LSSClaimType.Name)?.Value ?? string.Empty;
    }

    // 使用TryGetAsync避免LocalStorage读取失败抛出异常
    var themeResult = await LocalStorage.TryGetAsync<bool>(StoredData.MyTheme);
    isDarkMode = themeResult.Success ? themeResult.Value : false; // 设置默认值

    await base.OnInitializedAsync();
}

2. 检查IIS WebSocket协议配置 #

Blazor Server依赖WebSocket维持实时连接，Windows Server 2016的IIS默认可能未启用该协议：

• 打开服务器管理器 → 添加角色和功能 → 导航至Web服务器（IIS）> Web服务器 > 应用程序开发，勾选WebSocket协议并完成安装。
• 安装完成后重启IIS，确保站点WebSocket功能正常启用。

3. 验证.NET Hosting Bundle版本 #

Windows Server 2016自带的.NET运行时版本可能落后于你的应用目标框架，导致兼容性问题：

• 确认服务器已安装与应用目标.NET版本（如.NET 6/.NET 7）匹配的**.NET Hosting Bundle**，且为最新补丁版本。
• 可在控制面板 > 程序和功能中查看已安装的Hosting Bundle，若版本过低，下载对应版本重新安装后重启服务器。

4. 检查IIS身份验证配置 #

确保Windows Server 2016上的IIS身份验证设置与2012/2019一致：

• 若应用使用Windows身份验证，确认站点已启用该功能，且应用池身份拥有足够权限读取用户Claims。
• 检查是否禁用了必要的身份验证模块，导致HttpContext.User为空。

5. 启用详细日志定位根源 #

在appsettings.json中开启Blazor Server的DEBUG级日志，获取更详细的异常堆栈：

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

部署后查看事件查看器 > Windows日志 > 应用程序中的日志，定位异常触发的具体代码行。

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