如何在Blazor作用域中正确设置当前tenantId（兼容MVC/Razor）

问题背景 #

现有ASP.NET Core 6 MVC多租户应用，支持运行时创建、编辑、切换租户，依赖租户的服务（如NPoco数据库访问）通过作用域服务ITenantContext获取当前租户ID生成数据库连接串。

当前MVC/Web API/Razor的实现逻辑：

• 通过路由参数tenantId识别租户，示例路由：

  [HttpGet]
  [Route("api/{tenantId}/example")]
  

• 自定义IMiddleware从URL提取tenantId并注入到作用域ITenantContext：

  var tenantId = context.Request.RouteValues["tenantId"];
  context.RequestServices.GetRequiredService<ITenantContext>().Current = tenantId;
  

集成Blazor Server后出现问题：

• Blazor组件注入的ITenantContext与Middleware实例不一致，导致数据库服务无法获取正确租户ID
• 尝试用AsyncLocal替代作用域服务，发现Blazor运行在独立SynchronizationContext中，上下文无法共享

要求：解决Blazor的租户上下文传递问题，不破坏原有MVC/Razor逻辑，且服务层保持Blazor无关性。

解决方案 #

1. 重构ITenantContext实现，兼容双上下文 #

保留作用域服务基础，结合AsyncLocal实现跨HTTP/Blazor上下文的租户ID共享，同时兼容原有逻辑：

public interface ITenantContext
{
    string? Current { get; set; }
}

public class TenantContext : ITenantContext
{
    // 用于Blazor SignalR连接的AsyncLocal存储
    private static readonly AsyncLocal<string?> _asyncLocalTenantId = new();
    // 用于传统HTTP请求的作用域存储
    private string? _scopedTenantId;

    public string? Current
    {
        get => _asyncLocalTenantId.Value ?? _scopedTenantId;
        set
        {
            _asyncLocalTenantId.Value = value;
            _scopedTenantId = value;
        }
    }
}

2. 保留原有Middleware逻辑，无需修改 #

原Middleware的租户ID注入逻辑保持不变，写入的值会同时同步到AsyncLocal和作用域存储：

public class TenantMiddleware
{
    private readonly RequestDelegate _next;

    public TenantMiddleware(RequestDelegate next) => _next = next;

    public async Task InvokeAsync(HttpContext context)
    {
        if (context.Request.RouteValues.TryGetValue("tenantId", out var tenantIdObj) 
            && tenantIdObj is string tenantId)
        {
            var tenantContext = context.RequestServices.GetRequiredService<ITenantContext>();
            tenantContext.Current = tenantId;
        }

        await _next(context);
    }
}

3. 为Blazor添加租户初始化逻辑 #

Blazor SignalR连接建立时，需从初始请求路由提取租户ID并写入上下文，推荐两种实现方式：

方式一：根组件初始化（简单直接）

在MainLayout.razor中完成租户ID初始化：

@inject IHttpContextAccessor HttpContextAccessor
@inject ITenantContext TenantContext
@code {
    protected override void OnInitialized()
    {
        if (HttpContextAccessor.HttpContext?.Request.RouteValues.TryGetValue("tenantId", out var tenantIdObj) == true
            && tenantIdObj is string tenantId)
        {
            TenantContext.Current = tenantId;
        }
    }
}

方式二：自定义Hub过滤器（优雅解耦）

创建Hub过滤器，在Blazor连接建立时自动设置租户ID：

public class TenantHubFilter : IHubFilter
{
    private readonly IHttpContextAccessor _httpContextAccessor;
    private readonly ITenantContext _tenantContext;

    public TenantHubFilter(IHttpContextAccessor httpContextAccessor, ITenantContext tenantContext)
    {
        _httpContextAccessor = httpContextAccessor;
        _tenantContext = tenantContext;
    }

    public async ValueTask<object?> InvokeMethodAsync(HubInvocationContext invocationContext, Func<HubInvocationContext, ValueTask<object?>> next)
    {
        // 仅在首次连接时初始化租户ID
        if (invocationContext.MethodName == "Connect")
        {
            if (_httpContextAccessor.HttpContext?.Request.RouteValues.TryGetValue("tenantId", out var tenantIdObj) == true
                && tenantIdObj is string tenantId)
            {
                _tenantContext.Current = tenantId;
            }
        }
        return await next(invocationContext);
    }
}

在Program.cs中注册过滤器：

builder.Services.AddSignalR(options =>
{
    options.AddFilter<TenantHubFilter>();
});

4. 服务注册配置 #

保持ITenantContext的作用域注册，并添加IHttpContextAccessor支持：

builder.Services.AddScoped<ITenantContext, TenantContext>();
builder.Services.AddHttpContextAccessor();

关键优势 #

• 完全兼容：原有MVC/Web API/Razor逻辑无任何改动，正常运行
• Blazor无关性：服务层仅依赖ITenantContext，无需感知Blazor存在
• 可靠性：结合AsyncLocal和作用域存储，同时支持传统HTTP请求与Blazor SignalR连接上下文

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