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