.NET 5 Blazor应用Linux容器中HttpContext.User.Identity.Name为空问题

安全阿岳

2026-10-2

问题原因

基础镜像缺少依赖：.NET 5.0官方Linux ASP.NET基础镜像默认没有预装Kerberos、NTLM、LDAP相关的系统依赖包，Negotiate认证在Linux环境下运行需要这些底层库支持，导致认证流程无法正常完成，用户身份信息无法被正确填充。
服务注册生命周期错误：你重复注册了IHttpContextAccessor，services.AddHttpContextAccessor()已经默认将其注册为Scoped生命周期，手动注册Singleton的IHttpContextAccessor会导致上下文无法正常随请求更新；同时ContextHelper依赖IHttpContextAccessor，将其注册为Singleton会捕获到初始空上下文，后续请求无法拿到正确的用户信息。
Blazor Server 上下文获取逻辑缺陷：如果是Blazor Server模式，仅初始页面加载请求带有HttpContext，后续通过SignalR进行的交互不会携带HttpContext，直接通过IHttpContextAccessor获取会得到空值。
缺少Kerberos配置：Linux环境下使用Negotiate认证需要正确的krb5.conf域配置，容器默认没有该配置，无法和域控、LDAP服务器完成身份校验。
中间件顺序错误：若Startup的Configure方法中没有按顺序添加UseAuthentication()、UseAuthorization中间件，或者顺序错误，会导致身份认证逻辑未生效。

解决步骤

第一步：修改Dockerfile安装系统依赖
在base镜像阶段添加依赖安装逻辑，代码如下：

FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base
WORKDIR /app
# 安装Negotiate、LDAP所需依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    krb5-user \
    gss-ntlmssp \
    libldap-2.4-2 \
    && rm -rf /var/lib/apt/lists/*
EXPOSE 8080
EXPOSE 443
EXPOSE 80

第二步：修正服务注册逻辑
删除重复和错误生命周期的注册代码，修正后如下：

services.AddAuthentication(NegotiateDefaults.AuthenticationScheme)
.AddNegotiate(options =>
{
    if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
    {
        options.EnableLdap("someinternaladdy.org");
    }
});
// 仅保留官方提供的注册方法，默认已注册为Scoped
services.AddHttpContextAccessor();
// ContextHelper改为Scoped生命周期，和依赖的IHttpContextAccessor保持一致
services.AddScoped<IContextHelper , ContextHelper>();

第三步：配置Kerberos域信息
将适配你内部域的krb5.conf配置文件挂载到容器的/etc/krb5.conf路径，配置中需要包含域控制器地址、默认域、DNS解析规则等信息，同时确保容器网络可以正常访问LDAP服务器和域控的对应端口（默认389、88端口）。
第四步：适配Blazor Server的用户信息获取逻辑
如果是Blazor Server模式，不要在组件中直接调用GetUserName()方法，改为在_Host.cshtml初始渲染阶段获取用户名，通过参数传递给根组件，再注入到全局Scoped服务中供后续组件使用。
第五步：校验中间件顺序
确保Startup的Configure方法中中间件顺序正确，示例如下：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他前置中间件
    app.UseRouting();
    // 认证必须在授权之前，且必须在路由之后、端点之前
    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapBlazorHub();
        endpoints.MapFallbackToPage("/_Host");
    });
}

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