不能直接 new HttpClient()，因其设计为线程安全、可复用的长生命周期对象，频繁创建销毁会导致端口耗尽、DNS 缓存不更新、连接无法复用；根本在于底层 HttpMessageHandler 才管理连接池和 DNS，需由 IHttpClientFactory 统一管控生命周期。
为什么不能直接 new HttpClient()？
因为 HttpClient 设计上是线程安全、可复用的“长生命周期对象”，但很多人误把它当短命对象用：每次发请求都 new HttpClient()，再 Dispose()。这会导致端口耗尽（SocketException: Address already in use）、DNS 缓存不更新、连接无法复用等问题。
根本原因不是 HttpClient 本身有问题，而是它底层依赖的 HttpMessageHandler（比如 HttpClientHandler）才是真正管理连接池和 DNS 的核心——而这个 handler 必须被复用或按策略重建。
IHttpClientFactory 怎么解决连接泄漏？
IHttpClientFactory 不是简单帮你 new 一个 HttpClient，而是封装了 handler 生命周期管理 + 连接池复用 + 命名化配置 + 日志集成。它背后维护一个 handler 池，按命名逻辑复用或轮换 handler 实例，避免频繁重建 TCP 连接和 SSL 握手。
关键行为：
- 每次调用
CreateClient("api")返回的是**新实例**的HttpClient，但它的Handler很可能复用了之前创建的（取决于策略） - 工厂会自动清理过期的
HttpMessageHandler（默认 2 分钟空闲后释放） - handler 复用时，DNS 解析结果也会被缓存（除非显式禁用
UseProxy = false或设置DnsRefreshTimeout）
怎么注册并配置命名客户端？
在 Program.cs（.NET 6+）中注册：
builder.Services.AddHttpClient<IUserRepository, UserRepository>("user-api")
.SetHandlerLifetime(TimeSpan.FromMinutes(5))
.ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler
{
ServerCertificateCustomValidationCallback = (m, c, ch, p) => true // 仅调试
})
.AddTypedClient<IUserRepository>((httpClient, sp) => new UserRepository(httpClient));
注意点：
-
AddHttpClient<tclient timplementation>("name")</tclient>是推荐写法，绑定命名 + 类型 + 实现 -
SetHandlerLifetime控制 handler 复用时长，设为TimeSpan.Zero表示每次新建 handler（适合需要强制刷新 DNS 的场景） - 不要在
ConfigurePrimaryHttpMessageHandler里返回单例HttpClientHandler实例——工厂会自己管理 handler 生命周期 - 若用
AddHttpMessageHandler<authhandler>()</authhandler>，该中间件也受工厂生命周期控制
仓储层怎么安全注入和使用？
仓储构造函数接收 IHttpClientFactory 或直接用**类型化客户端**（更推荐）：
public class UserRepository : IUserRepository
{
private readonly HttpClient _httpClient;
public UserRepository(HttpClient httpClient) // 工厂自动注入命名客户端
{
_httpClient = httpClient;
_httpClient.Timeout = TimeSpan.FromSeconds(10);
}
public async Task<User> GetAsync(int id)
{
var response = await _httpClient.GetAsync($"/users/{id}");
response.EnsureSuccessStatusCode();
return await response.Content.ReadFromJsonAsync<User>();
}
}
常见陷阱：
- 别在仓储里保存
IHttpClientFactory并每次调用CreateClient——绕过类型化注册，失去命名策略和日志上下文 - 不要手动
Dispose注入的HttpClient——它由工厂管理，Dispose 会导致后续请求失败（ObjectDisposedException） - 超时必须设在客户端实例上（如
_httpClient.Timeout），而不是 handler 层；handler 层的Timeout被忽略
handler 生命周期和 DNS 刷新时机容易被忽视，尤其在服务发现或蓝绿部署场景下，SetHandlerLifetime 和 DnsRefreshTimeout 需要根据实际环境权衡。
