Blazor WebAssembly中IHttpClientBuilder加DelegatingHandler引发额外作用域问题

核心问题原因 #

HttpClientFactory在创建DelegatingHandler时会自动生成独立的依赖注入作用域，导致CustomMessageHandler注入的ScopedService和页面组件注入的不是同一个实例，进而出现数据修改后无法同步的问题。

可行解决方案 #

方案1：手动创建Scoped HttpClient实例（推荐）

放弃AddHttpClient的自动注册方式，改为在Scoped层级关联当前作用域的CustomMessageHandler：

1. 将CustomMessageHandler注册为Scoped服务：

builder.Services.AddScoped<CustomMessageHandler>();

2. 创建Scoped的HttpClient包装服务，确保和页面共享同一作用域：

public class ScopedHttpClientWrapper
{
    public HttpClient Client { get; }

    public ScopedHttpClientWrapper(CustomMessageHandler handler, IHttpClientFactory factory)
    {
        Client = factory.CreateClient();
        // 添加当前作用域的Handler
        Client.AddHttpMessageHandler(handler);
        // 配置基础地址等参数
        Client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
    }
}

// 注册包装服务为Scoped
builder.Services.AddScoped<ScopedHttpClientWrapper>();

3. 在页面和CustomMessageHandler中注入对应服务：

• 页面使用ScopedHttpClientWrapper.Client发起请求
• CustomMessageHandler直接注入ScopedService即可，因自身是Scoped服务，和页面共享同一实例

方案2：手动传递共享服务实例

如果必须保留AddHttpClient的注册方式，可在组件中捕获当前Scoped服务实例并传递给Handler：

1. 修改CustomMessageHandler添加接收属性：

public class CustomMessageHandler : DelegatingHandler
{
    public ScopedService? SharedScopedService { get; set; }

    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        if (SharedScopedService == null)
            throw new InvalidOperationException("未初始化共享Scoped服务");
        
        // 这里使用SharedScopedService处理业务逻辑
        return await base.SendAsync(request, cancellationToken);
    }
}

2. 在页面组件中注入服务并绑定实例：

@inject IHttpClientFactory HttpClientFactory
@inject ScopedService PageScopedService

private HttpClient? _scopedHttpClient;

protected override void OnInitialized()
{
    _scopedHttpClient = HttpClientFactory.CreateClient();
    // 找到Handler实例并绑定页面的Scoped服务
    var handler = _scopedHttpClient.GetTypedMessageHandler<CustomMessageHandler>();
    handler.SharedScopedService = PageScopedService;
}

为什么之前的方案不可行？ #

• 改为Singleton：依赖库强制使用Scoped注册，无法兼容
• SuppressHandlerScope：Blazor WebAssembly的Scoped服务基于组件生命周期，根容器无法解析Scoped服务，此选项失效
• IHttpContextAccessor：Blazor WebAssembly不存在HttpContext，该服务无法正常工作

内容的提问来源于stack exchange，提问作者H.A.H.