如何在Blazor全边缘场景下可靠获取HttpContext

问题背景 #

我们需要从Blazor应用中获取当前连接用户的以下信息：

• SessionID
• IpAddress
• 用户标识名称（User Identity Name）

之前常用的方法是通过IHttpContextAccessor从HttpContext中获取，步骤如下：

1. 启动配置中添加服务：

builder.Services.AddHttpContextAccessor();

2. 在Blazor组件中注入服务：

@inject IHttpContextAccessor hca

3. 在组件中读取信息：

<p> SessionID: @hca.HttpContext?.Connection?.Id </p>
<p> IP: @hca.HttpContext?.Connection?.RemoteIpAddress </p>
<p> User: @hca.HttpContext?.User?.Identity?.Name </p>

该方法在.NET 6+（包括.NET 8）中仍可运行，但官方明确标记为不推荐的错误用法，且存在以下边缘场景限制：

限制1：LongPolling传输模式下HttpContext为Null #

当SignalR传输模式降级为LongPolling时，HttpContext会变为Null。可以通过启动配置强制启用LongPolling来测试：

app.MapBlazorHub(opt =>
{
    opt.Transports =
            //Microsoft.AspNetCore.Http.Connections.HttpTransportType.WebSockets |
            Microsoft.AspNetCore.Http.Connections.HttpTransportType.LongPolling;
});

部分场景下必须使用LongPolling，比如IIS 8及更早版本不支持WebSocket、反向代理受企业政策限制无法修改配置等。

官方曾推荐通过根组件参数级联传递初始请求状态的方案，但该方案依赖根组件（如App、_Host），无法覆盖所有场景。

限制2：JS实例化的非路由Blazor组件（集成到非Blazor应用） #

在.NET 8非Blazor Web应用中，我们通过JavaScript实例化单个非路由Blazor组件：

1. 启动配置中注册组件：

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents(options =>  
    {
        options.DetailedErrors = true;
        options.RootComponents.RegisterForJavaScript<SchedaWeb>(identifier: "scheda-web");
    });

2. JavaScript初始化代码：

Blazor.start()
    .then(function () {
        Blazor.rootComponents.add(_this.renderScheda[0], 'scheda-web', {
            id: id,
        })
    });

此场景下没有传统的根组件（无App、_Host），无法使用官方推荐的根组件参数传递方案，且使用LongPolling时HttpContext为Null，如何获取请求信息？

限制3：HttpContext本身不可靠 #

多篇技术文章（包括Blazor依赖的SignalR相关线程）指出HttpContext不可靠，官方文档明确建议：对于交互式组件中需要HttpContext的场景，推荐通过服务器的持久组件状态传递数据。

解决方案：通用可靠的实现方式 #

针对所有边缘场景（LongPolling传输、集成到非Blazor应用、无传统根组件），可靠获取用户请求信息的正确方式如下：

步骤1：创建请求状态模型 #

定义一个模型存储需要的请求信息：

public class RequestUserState
{
    public string SessionId { get; set; }
    public string IpAddress { get; set; }
    public string UserName { get; set; }
}

步骤2：在请求管道中捕获并持久化状态 #

在Program.cs中，添加中间件捕获初始请求的HttpContext信息，并将其存入服务器持久组件状态：

app.Use(async (context, next) =>
{
    // 捕获请求信息
    var userState = new RequestUserState
    {
        SessionId = context.Connection.Id,
        IpAddress = context.Connection.RemoteIpAddress?.ToString(),
        UserName = context.User.Identity?.Name
    };

    // 将状态存入服务器持久组件状态
    var serverState = context.RequestServices.GetRequiredService<ServerComponentState>();
    serverState.PersistAsJson("RequestUserState", userState);

    await next();
});

注意：该中间件需要放在MapBlazorHub和MapRazorComponents之前，确保初始请求时能捕获到信息。

步骤3：在组件中读取持久化状态 #

无论是传统Blazor组件还是JS实例化的非路由组件，都可以通过注入PersistentComponentState来读取状态：

@inject PersistentComponentState PersistentState

@code {
    private RequestUserState _userState;

    protected override void OnInitialized()
    {
        // 尝试从持久化状态读取
        if (PersistentState.TryTakeFromJson<RequestUserState>("RequestUserState", out var state))
        {
            _userState = state;
        }
    }
}

然后在组件模板中使用：

@if (_userState != null)
{
    <p> SessionID: @_userState.SessionId </p>
    <p> IP: @_userState.IpAddress </p>
    <p> User: @_userState.UserName </p>
}

关键说明 #

1. 服务器持久组件状态是官方推荐的传递初始请求数据的方式，它会将数据关联到组件会话，不受传输模式（WebSocket/LongPolling）影响。
2. 中间件捕获的是初始请求的HttpContext信息，这是唯一可靠的时机——因为SignalR建立连接后的后续请求（如LongPolling的轮询请求）无法保证HttpContext的一致性。
3. 对于JS实例化的组件，PersistentComponentState会自动关联到组件的会话，无需根组件级联传递，完美适配无根组件场景。

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