Blazor服务端使用HttpContext获取Windows用户名部署IIS报错如何解决？

问题成因 #

• IIS站点身份验证配置错误：本地开发环境默认启用Windows身份验证，而IIS部署时默认仅开启匿名身份验证，未开启Windows身份验证，导致User.Identity处于未认证状态，读取Name属性时触发空引用异常。
• Blazor服务端生命周期限制：Blazor服务端基于SignalR长连接运行，HttpContext仅在初始HTTP请求建立连接的阶段有效，后续业务逻辑执行时初始请求上下文已经被释放，直接访问httpContextAccessor.HttpContext会得到空值，触发空引用异常。
• 托管配置缺失：IIS的ASP.NET Core托管模块默认不会转发Windows身份令牌到应用，导致即使开启Windows身份验证，应用也拿不到用户身份信息。

修复步骤 #

1. 配置IIS站点身份验证 #

• 打开IIS管理器，定位到部署的Blazor服务端站点，进入「身份验证」功能页
• 禁用「匿名身份验证」，启用「Windows身份验证」
• 右键点击Windows身份验证选择「提供程序」，确保列表中存在Negotiate和NTLM两个提供程序

2. 调整服务注册配置 #

在Startup.cs的ConfigureServices方法中补充Windows身份验证注册：

// 原有注册保留
services.AddHttpContextAccessor();
// 新增Windows身份验证方案注册
services.AddAuthentication(IISDefaults.AuthenticationScheme);

注意需要引用命名空间Microsoft.AspNetCore.Authentication.IISIntegration。

3. 修正Razor页面的用户名读取逻辑 #

不要在业务方法中直接访问HttpContext，改为在组件初始化阶段读取用户名存入本地变量，避免上下文释放导致的空值问题：

@inject IHttpContextAccessor httpContextAccessor

@code {
    private string _userName;

    protected override Task OnInitializedAsync()
    {
        // 仅在初始化阶段读取HttpContext，此时上下文未被释放
        _userName = httpContextAccessor.HttpContext?.User.Identity?.Name;
        return base.OnInitializedAsync();
    }

    // 后续业务逻辑直接使用 _userName 变量即可
    private void YourBusinessMethod()
    {
        if (!string.IsNullOrEmpty(_userName))
        {
            // 执行你的业务逻辑
        }
    }
}

4. 修正web.config配置 #

在站点根目录的web.config文件中补充配置，确保IIS转发Windows身份令牌：

<system.webServer>
  <security>
    <authentication>
      <windowsAuthentication enabled="true" />
      <anonymousAuthentication enabled="false" />
    </authentication>
  </security>
  <!-- 原有aspNetCore节点新增forwardWindowsAuthToken="true"属性 -->
  <aspNetCore processPath="dotnet" arguments=".\你的应用名称.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="true" />
</system.webServer>

完成以上配置后重启IIS站点即可解决问题。

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