HttpClient 的使用准则

项目
09/04/2024

System.Net.Http.HttpClient 类用于发送 HTTP 请求以及从 URI 所标识的资源接收 HTTP 响应。 HttpClient 实例是应用于该实例执行的所有请求的设置集合，每个实例使用自身的连接池，该池将其请求与其他请求隔离开来。从 .NET Core 2.1 开始，SocketsHttpHandler 类提供实现，使行为在所有平台上保持一致。

DNS 行为

HttpClient 仅在创建连接时解析 DNS 条目。它不跟踪 DNS 服务器指定的任何生存时间 (TTL)。如果 DNS 条目定期更改（这可能在某些方案中发生），客户端将不会遵循这些更新。要解决此问题，可以通过设置 PooledConnectionLifetime 属性来限制连接的生存期，以便在替换连接时重复执行 DNS 查找。请考虑以下示例：

var handler = new SocketsHttpHandler
{
    PooledConnectionLifetime = TimeSpan.FromMinutes(15) // Recreate every 15 minutes
};
var sharedClient = new HttpClient(handler);

上述 HttpClient 配置为重复使用连接 15 分钟。在 PooledConnectionLifetime 指定的时间跨度过去且连接完成其最后一个关联请求（如果有）后，此连接将关闭。如果队列中有任何正在等待的请求，则会根据需要创建新的连接。

为了说明目的，任意选择了 15 分钟的时间间隔。应根据 DNS 或其他网络更改的预期频率选择该值。

共用连接

HttpClient 的连接池链接到其基础 SocketsHttpHandler。释放 HttpClient 实例时，它会释放池中的所有现有连接。如果稍后向同一服务器发送请求，则必须重新创建一个新连接。因此，创建不必要的连接会导致性能损失。此外，TCP 端口不会在连接关闭后立即释放。（有关这一点的详细信息，请参阅 RFC 9293 中的 TCP TIME-WAIT。）如果请求速率较高，则可用端口的操作系统限制可能会耗尽。为了避免端口耗尽问题，建议将 HttpClient 实例重用于尽可能多的 HTTP 请求。

静态客户端的复原能力

可使用以下模式将 static 或单一实例客户端配置为使用任意数量的复原管道：

using System;
using System.Net.Http;
using Microsoft.Extensions.Http;
using Microsoft.Extensions.Http.Resilience;
using Polly;

var retryPipeline = new ResiliencePipelineBuilder<HttpResponseMessage>()
    .AddRetry(new HttpRetryStrategyOptions
    {
        BackoffType = DelayBackoffType.Exponential,
        MaxRetryAttempts = 3
    })
    .Build();

var socketHandler = new SocketsHttpHandler
{
    PooledConnectionLifetime = TimeSpan.FromMinutes(15)
};
var resilienceHandler = new ResilienceHandler(retryPipeline)
{
    InnerHandler = socketHandler,
};

var httpClient = new HttpClient(resilienceHandler);

前面的代码：

依赖于 Microsoft.Extensions.Http.Resilience NuGet 包。
指定一个暂时性 HTTP 错误处理程序，该处理程序配置了重试管道，每次尝试都会指数退避延迟间隔。
定义 socketHandler 的入池连接生存期为 15 分钟。
使用重试逻辑将 socketHandler 传递给 resilienceHandler。
根据 resilienceHandler 实例化 HttpClient。

重要

Microsoft.Extensions.Http.Resilience 库当前标记为实验性，将来可能会更改。

通过

HttpClient 的使用准则

DNS 行为

共用连接

推荐使用

静态客户端的复原能力

另请参阅

其他资源