Blazor WebAssembly如何为所有HttpClient API请求统一添加请求头

完全不需要在每次发起请求时单独配置请求头，有两种成熟的统一配置方案，你现有业务代码（比如UserService里的请求逻辑）不需要做任何修改就能生效。

方案1：直接配置HttpClient默认请求头（固定密钥场景首选） #

如果你的访问密钥是固定值（比如从配置文件读取的固定API Key），直接在注册HttpClient时给DefaultRequestHeaders赋值即可，这是最简单的实现方式：

// 替换你原来的HttpClient注册代码
builder.Services.AddScoped(sp => 
{
    var httpClient = new HttpClient { BaseAddress = new Uri("https://localhost:7280/") };
    // 统一添加自定义访问密钥请求头，把头名称和密钥替换成你实际使用的值
    httpClient.DefaultRequestHeaders.Add("X-API-KEY", "你的指定访问密钥值");
    return httpClient;
});

所有通过这个HttpClient实例发出的请求，都会自动携带你配置的默认请求头。

方案2：使用自定义消息处理器（动态密钥/需扩展逻辑场景） #

如果你的访问密钥不是固定值（比如需要从本地存储读取、会随用户登录状态变化），或者后续还要加统一的请求日志、响应预处理、异常处理等逻辑，推荐用DelegatingHandler实现，扩展性更强：

1. 首先自定义消息处理类：

public class ApiKeyHeaderHandler : DelegatingHandler
{
    // 如果需要读取本地存储、配置等服务，直接通过构造函数注入即可
    // 比如注入ILocalStorageService、IConfiguration等服务
    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        // 在这里统一添加请求头，支持动态取值
        request.Headers.Add("X-API-KEY", "动态获取到的访问密钥值");
        // 如需加其他统一头（比如追踪ID、认证token等）都可以在这里统一处理
        return await base.SendAsync(request, cancellationToken);
    }
}

2. 注册服务时关联处理器：

// 先注册自定义处理器
builder.Services.AddScoped<ApiKeyHeaderHandler>();
// 注册HttpClient并挂载处理器
builder.Services.AddScoped(sp =>
{
    return new HttpClient(sp.GetRequiredService<ApiKeyHeaderHandler>())
    {
        BaseAddress = new Uri("https://localhost:7280/")
    };
});

注意：Blazor WebAssembly运行在浏览器沙箱中，自定义消息处理器的逻辑会在前端执行，不要在处理器里硬编码敏感密钥，如果密钥需要保密，要通过受保护的浏览器存储读取，或者走后端中转逻辑。

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