Blazor WebAssembly中给DelegatingHandler注入服务配置HttpClient报错求助

错误原因分析 #

这个报错的核心是：你自定义的DelegatingHandler要么被复用/缓存了，要么提前设置了InnerHandler。IHttpClientFactory在创建客户端时会自动构建请求处理链，包括为DelegatingHandler分配最终的InnerHandler（比如HttpClientHandler），不允许外部提前指定或复用Handler实例。

1. 修正自定义DelegatingHandler实现 #

确保Handler只注入依赖，不手动设置InnerHandler，示例代码：

public class AuthHeaderHandler : DelegatingHandler
{
    private readonly IBrowserStorageService _browserStorage;

    // 仅注入IBrowserStorageService，不初始化InnerHandler
    public AuthHeaderHandler(IBrowserStorageService browserStorage)
    {
        _browserStorage = browserStorage;
    }

    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        // 从LocalStorage读取所需数据（示例：读取认证Token）
        var authToken = await _browserStorage.GetItemAsync<string>("auth_token");
        if (!string.IsNullOrWhiteSpace(authToken))
        {
            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", authToken);
        }

        // 调用基类方法继续处理请求
        return await base.SendAsync(request, cancellationToken);
    }
}

2. 正确配置Program.cs中的服务注册 #

关键要将自定义Handler注册为Transient（每次创建HttpClient都生成新实例），并通过AddHttpMessageHandler关联到HttpClient：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// 1. 注册LocalStorage服务（如果用Blazored.LocalStorage库）
builder.Services.AddBlazoredLocalStorage();

// 2. 注册自定义Handler为Transient，禁止复用
builder.Services.AddTransient<AuthHeaderHandler>();

// 3. 配置HttpClient并关联自定义Handler
builder.Services.AddHttpClient("MyClient", client =>
{
    client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
    // 可添加其他默认配置，比如超时、请求头
})
.AddHttpMessageHandler<AuthHeaderHandler>();

// 4. 注册你的业务请求服务（注入IHttpClientFactory）
builder.Services.AddScoped<MyApiRequestService>();

await builder.Build().RunAsync();

3. 业务请求服务的正确写法 #

通过IHttpClientFactory创建指定名称的HttpClient即可：

public class MyApiRequestService
{
    private readonly HttpClient _httpClient;

    public MyApiRequestService(IHttpClientFactory clientFactory)
    {
        // 创建配置好的"MyClient"客户端
        _httpClient = clientFactory.CreateClient("MyClient");
    }

    // 示例API请求方法
    public async Task<MyDataModel> GetDataAsync()
    {
        return await _httpClient.GetFromJsonAsync<MyDataModel>("api/data");
    }
}

关键注意事项 #

• 自定义DelegatingHandler必须注册为Transient，不能是Singleton或Scoped，否则会被复用导致报错
• 绝对不要手动设置DelegatingHandler的InnerHandler属性，交给IHttpClientFactory自动处理
• 如果使用第三方LocalStorage库（如Blazored.LocalStorage），确保已正确安装NuGet包并注册服务

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