摘要：在 .NET 项目开发中，HttpClient几乎是调用外部 API 的必备工具。它使用简单，但如果不了解其内部机制，往往会踩坑，甚至导致服务雪崩、端口耗尽等严重问题。
在 .NET 项目开发中，HttpClient几乎是调用外部 API 的必备工具。它使用简单，但如果不了解其内部机制，往往会踩坑，甚至导致服务雪崩、端口耗尽等严重问题。
今天我们就来盘点一下 HttpClient 中常见的坑，以及对应的最佳实践。
using (var client = new HttpClient){
var response = await client.GetAsync(url);
}
表面上这是标准的 C# 资源释放模式，但 HttpClient 内部维护了 连接池。频繁创建和释放，会导致端口耗尽（Socket Exhaustion），最终请求失败。
✅ 最佳实践：HttpClient 应该复用。
在 ASP.NET Core 中推荐使用IHttpClientFactory来统一管理生命周期：builder.Services.AddHttpClient("MyClient", client =>{
client.BaseAddress = new Uri("https://api.example.com");
});httpClient.DefaultRequestHeaders.Add("Authorization", "Bearer xxx");
注意！所有后续请求都会带上这个 Header。在多用户、多服务场景下可能导致严重问题。
✅ 最佳实践：推荐在请求级别设置 Header。
var request = new HttpRequestMessage(HttpMethod.Get, "/data");request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);var response = await httpClient.GetAsync("/data");
var content = await response.Content.ReadAsStringAsync;Dispose，连接会长时间占用。✅ 最佳实践：使用using语法确保释放。using var response = await httpClient.GetAsync("/data");
response.EnsureSuccessStatusCode;
var content = await response.Content.ReadAsStringAsync;
HttpClient 默认超时时间是 100 秒。在高并发环境下，如果目标服务响应缓慢，可能会导致请求堆积。
✅ 最佳实践：设置合理的超时时间。
httpClient.Timeout = TimeSpan.FromSeconds(10);或者使用精确控制：using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));await httpClient.GetAsync("/data", cts.Token);
在早期 .NET Framework 中，HttpClient 单例会导致 DNS 缓存永不过期。域名变更后，服务依然请求旧的 IP。
在 .NET Core 已经优化了这一点，但如果是老项目，可以手动指定连接生命周期：
builder.Services.AddHttpClient("MyClient").ConfigurePrimaryHttpMessageHandler( =>
new SocketsHttpHandler
{
PooledConnectionLifetime = TimeSpan.FromMinutes(2)
});很多人习惯使用ReadAsStringAsync，但如果返回的是大文件（如日志、视频），会直接把内存撑爆。
✅ 最佳实践：采用流式处理。
using var response = await httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);await using var stream = await response.Content.ReadAsStreamAsync;
// 手动处理流
网络调用难免失败，如果没有重试机制，服务稳定性会大打折扣。
✅ 最佳实践：结合Polly添加重试策略。
builder.Services.AddHttpClient("MyClient").AddPolicyHandler(Policy
.Handle
.OrResult
.WaitAndRetryAsync(3, retry => TimeSpan.FromSeconds(retry)));
·············· END ··············
来源：opendotnet