Flurl 4.0中如何移除CustomHttpClientFactory并完成迁移？

原3.x实现背景 #

• 自定义BearerTokenManagingHttpClientFactory继承自DefaultHttpClientFactory，重写两个核心方法：
  • CreateHttpClient()：为客户端添加通用请求头
  • CreateMessageHandler()：返回自定义的BearerTokenMessageHandler（继承自DelegatingHandler）
• 原客户端初始化代码：

var cli = new FlurlClient(BASE_URL).Configure(settings => {
    settings.HttpClientFactory = new MyCustomHttpClientFactory();
});

4.0等效实现 #

Flurl 4.0移除了HttpClientFactory配置项，改用直接配置HttpClient和注册消息处理器的方式替代原有逻辑，具体实现分两部分：

1. 配置通用请求头（替代CreateHttpClient逻辑） #

直接通过ConfigureHttpClient方法设置HttpClient的默认请求头：

var cli = new FlurlClient(BASE_URL)
    .ConfigureHttpClient(httpClient => {
        // 这里添加原工厂类中设置的所有通用请求头
        httpClient.DefaultRequestHeaders.Add("X-Custom-Header", "fixed-value");
        httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
        // 其他请求头配置...
    });

2. 注册自定义BearerTokenMessageHandler（替代CreateMessageHandler逻辑） #

使用ConfigureInnerHandler方法注册你的自定义DelegatingHandler：

var cli = new FlurlClient(BASE_URL)
    .ConfigureInnerHandler(() => new BearerTokenMessageHandler());

完整组合示例 #

如果需要同时配置请求头和自定义处理器，可将两者结合：

var cli = new FlurlClient(BASE_URL)
    .ConfigureHttpClient(httpClient => {
        // 配置通用请求头
        httpClient.DefaultRequestHeaders.Add("X-App-Version", "2.0.0");
        httpClient.DefaultRequestHeaders.Add("X-Environment", "production");
    })
    .ConfigureInnerHandler(() => new BearerTokenMessageHandler());

关键注意点 #

• 4.0中不再需要继承DefaultHttpClientFactory，原有工厂类的逻辑拆分到ConfigureHttpClient和ConfigureInnerHandler中
• 自定义DelegatingHandler的业务逻辑无需修改，直接通过ConfigureInnerHandler注册即可生效
• 若需要构建多处理器链，可在ConfigureInnerHandler中串联多个DelegatingHandler：

.ConfigureInnerHandler(() => new BearerTokenMessageHandler(new AnotherCustomHandler()));

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