HttpClientHandler 底层处理器

`HttpClientHandler` 发送请求底层处理器#

HttpClientHandler 是 .NET 中用于配置和执行实际 HTTP 请求的核心消息处理器。它是 HttpMessageHandler 的具体实现类，通常作为 HttpClient 消息处理管道的最末端，负责与操作系统网络层交互，完成真正的 HTTP 请求发送与响应接收。

虽然 DelegatingHandler 和 HttpClientHandler 都继承自 HttpMessageHandler，但它们在职责上有明显区分：

DelegatingHandler：用于构建可插拔、链式的中间件逻辑（如日志、认证、重试等），本身不直接发起网络请求，而是将请求委托给下一个处理器。
HttpClientHandler：是最终执行网络 I/O 的处理器，封装了平台相关的底层实现（如 WinHTTP、libcurl 或 SocketsHttpHandler），并提供丰富的配置选项来控制连接行为、安全策略、代理设置等。

`HttpClientHandler` 的核心功能#

HttpClientHandler 提供了对 HTTP 客户端行为的精细控制，常见配置包括：

自动重定向（AllowAutoRedirect）
Cookie 容器管理（UseCookies + CookieContainer）
代理设置（Proxy + UseProxy）
证书验证与 TLS 配置（ServerCertificateCustomValidationCallback）
连接超时与请求超时（Timeout、ConnectTimeout）
是否使用默认凭据（UseDefaultCredentials）
压缩支持（AutomaticDecompression）

与 `DelegatingHandler` 的协作关系#

当你通过 services.AddHttpClient() 创建 HttpClient 时，.NET 默认会为你提供一个 HttpClientHandler 作为管道的“终点”。所有通过 .AddHttpMessageHandler<T>() 添加的 DelegatingHandler 实例，都会被包装在 HttpClientHandler 之外，形成如下调用链：

CustomHandler3 → CustomHandler2 → CustomHandler1 → HttpClientHandler → 网络

也就是说：

请求从最外层的 DelegatingHandler 开始，逐层向内传递；
响应则从 HttpClientHandler 返回后，逐层向外回传；
HttpClientHandler 是唯一真正发出网络请求的组件。

自定义 `HttpClientHandler`#

虽然大多数拦截逻辑应通过 DelegatingHandler 实现，但 HttpClientHandler 本身也是可继承的，允许你在最接近网络 I/O 的层级插入自定义行为。这适用于需要深度控制底层请求/响应流程的场景，例如：

模拟特定网络错误
在 TLS 握手前后注入监控
绕过默认的 Cookie 或代理处理逻辑
捕获或转换底层网络异常

以下是一个继承 HttpClientHandler 的示例，展示了如何在请求发送前添加自定义请求头，并在响应接收后记录状态码：

public class CustomHttpHandler : HttpClientHandler{    /// <inheritdoc />    protected override HttpResponseMessage Send(HttpRequestMessage request, CancellationToken cancellationToken)    {        // 参考异步 SendAsync 方法        return base.Send(request, cancellationToken);    }    /// <inheritdoc />    protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)    {        // 请求预处理：添加自定义请求头        request.Headers.Add("Custom-Header", "Value");        // 发送请求并获取响应        var response = await base.SendAsync(request, cancellationToken);        // 响应后处理：记录响应状态码        Console.WriteLine($"Response status code: {response.StatusCode}");        return response;    }}

接下来，在 Program.cs 或 Startup.cs 文件中配置并初始化 CustomHttpHandler：

// 为默认 HttpClient 客户端启用services.AddHttpClient(string.Empty)    .ConfigurePrimaryHttpMessageHandler(() => new CustomHttpHandler());// 若为特定命名的 HttpClient 客户端启用，可如下配置// services.AddHttpClient("weixin")//     .ConfigurePrimaryHttpMessageHandler(() => new CustomHttpHandler());

注意：ConfigurePrimaryHttpMessageHandler 设置的是整个管道的底层处理器，它必须是 HttpMessageHandler 的具体实现（如 HttpClientHandler、SocketsHttpHandler），不能是 DelegatingHandler。

最佳实践建议#

不要轻易替换默认的 HttpClientHandler，除非你需要特殊的安全或连接行为。
若需添加业务逻辑（如日志、重试、认证），优先使用 DelegatingHandler。
在需要精细控制 TLS、代理、Cookie 或超时策略等底层网络行为时，才考虑自定义 HttpClientHandler。

HttpClientHandler 发送请求底层处理器#

HttpClientHandler 的核心功能#

与 DelegatingHandler 的协作关系#

自定义 HttpClientHandler#

最佳实践建议#

`HttpClientHandler` 发送请求底层处理器#

`HttpClientHandler` 的核心功能#

与 `DelegatingHandler` 的协作关系#

自定义 `HttpClientHandler`#