ASP.NET Core 2.1中类型化HttpClient如何注入IAccessTokenCache？

你遇到的核心问题是：AddHttpClient的配置委托是在DI容器初始化阶段执行的，没法直接获取IAccessTokenCache这类依赖，而且静态设置的默认头也没法处理令牌过期刷新的场景。最适合的解决方案是用自定义DelegatingHandler来实现动态令牌注入，这完全适配ASP.NET Core 2.1的HttpClientFactory，配置集中且工作量小。

具体步骤： #

1. 创建OAuth令牌处理Handler

这个Handler会在每个请求发送前，从IAccessTokenCache获取令牌并添加到请求头，同时能天然支持令牌的缓存和刷新逻辑（因为你的IAccessTokenCache已经实现了这些）：

public class OAuthTokenHandler : DelegatingHandler
{
    private readonly IAccessTokenCache _tokenCache;

    // 直接通过构造函数注入IAccessTokenCache
    public OAuthTokenHandler(IAccessTokenCache tokenCache)
    {
        _tokenCache = tokenCache;
    }

    protected override async Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request, 
        CancellationToken cancellationToken)
    {
        // 调用你的缓存组件获取对应服务的令牌
        // 这里假设GetTokenAsync方法接收服务标识和取消令牌参数
        var accessToken = await _tokenCache.GetTokenAsync("FooService", cancellationToken);
        
        if (!string.IsNullOrEmpty(accessToken))
        {
            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
        }

        // 传递请求到下一个Handler（最终到HttpClient）
        return await base.SendAsync(request, cancellationToken);
    }
}

2. 注册Handler和依赖

先把你的IAccessTokenCache实现及自定义Handler注册到DI容器：

// 注册令牌缓存组件（根据你的实际实现调整生命周期）
services.AddSingleton<IAccessTokenCache, YourAccessTokenCacheImpl>();

// 注册自定义Handler（用Transient，因为每个客户端可能需要独立实例）
services.AddTransient<OAuthTokenHandler>();

3. 配置类型化客户端

在配置ServiceFooClient时，只需把这个Handler添加到客户端的消息管道中，无需再在配置委托里硬编码令牌：

services
    .AddHttpClient<ServiceFooClient>(c => {
        c.BaseAddress = new Uri("https://www.foo.svc");
        // 这里不再需要设置Authorization头，交给OAuthTokenHandler处理
    })
    .AddHttpMessageHandler<OAuthTokenHandler>() // 添加令牌处理Handler
    .AddHttpMessageHandler<ResponseMonitorHandler>()
    .ConfigureHttpMessageHandlerBuilder(b => {
        var handler = b.AdditionalHandlers.OfType<ResponseMonitorHandler>().FirstOrDefault();
        if (handler != null) {
            handler.ServiceName = "Foo Service";
        }
    });

为什么这个方案更好？ #

• 配置集中：所有OAuth相关逻辑都封装在一个Handler里，多个客户端只需复用这个Handler即可，避免重复代码。
• 动态令牌支持：每次请求都会从缓存获取最新令牌，自动适配令牌刷新场景，比静态设置默认头可靠得多。
• 无兼容性风险：完全基于ASP.NET Core 2.1原生的HttpClientFactory特性，不需要额外依赖或修改框架行为。
• 依赖注入友好：Handler通过构造函数直接获取IAccessTokenCache，符合DI设计原则。

如果后续有其他服务客户端需要OAuth授权，只需要在它们的AddHttpClient链中加上.AddHttpMessageHandler<OAuthTokenHandler>()就行，非常省心。

内容的提问来源于stack exchange，提问作者Zdeněk