在.NET应用程序中调用外部接口已经是再普通不过的需求了，无论是请求第三方API、下载网页内容，还是对接微服务，都离不开HTTP客户端。C#为我们提供的官方方案就是HttpClient这个类。它功能完善，支持异步操作，但用起来也有不少讲究的地方，比如实例的生命周期管理、连接池复用等问题，稍不注意就会踩坑。这篇文章就从基础概念到实战代码，把HttpClient的使用方法完整梳理一遍。
HttpClient到底是什么
HttpClient是.NET Framework 4.5开始引入、并在.NET Core和.NET 5以后大力推广的HTTP客户端类，位于System.Net.Http命名空间下。它的定位是作为一个可复用的HTTP请求发送器，一个实例可以贯穿整个应用生命周期，内部维护着连接池，能够对TCP连接进行复用，避免频繁握手带来的性能损耗。
它和我们早年常用的HttpWebRequest相比，API设计更加现代化。首先它原生支持async/await异步编程模型，所有请求方法都返回Task对象，不会阻塞线程；其次它对HTTP语义的抽象更清晰，请求用HttpRequestMessage表示，响应用HttpResponseMessage表示，请求体和响应体则统一抽象为HttpContent的派生类，比如StringContent、FormUrlEncodedContent、ByteArrayContent等，层次非常清楚。
需要特别强调一点：HttpClient这个类型是线程安全的，多个线程可以同时使用同一个实例发送请求。这一点决定了它的正确用法应该是全局单例或者通过IHttpClientFactory管理，而不是每次请求都new一个。曾经有大量生产事故就是因为开发者在每个方法调用里创建HttpClient实例，用完就释放，导致服务器端口被TIME_WAIT状态的连接耗尽，出现SocketException错误。这是使用HttpClient时最经典的陷阱，后面会详细展开。
发送GET请求并处理响应
GET请求是最简单的场景，直接调用GetAsync方法传入URL即可。返回的HttpResponseMessage对象包含了状态码、响应头和响应体三部分信息。先看一个基础的例子：
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
// 建议作为静态单例使用，避免端口耗尽
private static readonly HttpClient client = new HttpClient();
static async Task Main()
{
try
{
// 发送GET请求
HttpResponseMessage response = await client.GetAsync("https://api.ipipp.com/users/1");
// 先检查状态码是否成功（2xx）
if (response.IsSuccessStatusCode)
{
// 读取响应体为字符串
string body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
else
{
Console.WriteLine($"请求失败，状态码：{response.StatusCode}");
}
}
catch (HttpRequestException ex)
{
// 网络层异常，如DNS解析失败、连接被拒绝
Console.WriteLine($"网络异常：{ex.Message}");
}
catch (TaskCanceledException)
{
Console.WriteLine("请求超时");
}
}
}这段代码里有几个关键点。第一，ReadAsStringAsync本身也是异步方法，因为响应体可能很大，需要流式读取。第二，IsSuccessStatusCode属性等价于状态码在200到299之间，这是判断请求是否成功的推荐方式。第三，如果希望状态码不成功时直接抛异常，可以改用EnsureSuccessStatusCode方法，它会在非2xx状态下抛出HttpRequestException，代码可以更简洁。
有时候我们拿到的响应是JSON格式，需要反序列化成C#对象。可以结合System.Text.Json来实现，示例代码如下：
using System.Net.Http;
using System.Net.Http.Json; // 需要引用 System.Net.Http.Json 包
using System.Threading.Tasks;
public class User
{
public int Id { get; set; }
public string Name { get; set; }
}
public class UserService
{
private readonly HttpClient _client;
public UserService(HttpClient client)
{
_client = client;
}
public async Task<User> GetUserAsync(int id)
{
// GetFromJsonAsync一步完成请求和反序列化
User user = await _client.GetFromJsonAsync<User>($"https://api.ipipp.com/users/{id}");
return user;
}
}GetFromJsonAsync是System.Net.Http.Json扩展库提供的便捷方法，它把发送请求、检查状态码、读取内容、JSON反序列化这些步骤全部打包了，一行代码搞定，实际项目中非常好用。类似的还有GetFromJsonAsync对应的写入版本PostAsJsonAsync，下面马上会讲到。
发送POST、PUT、DELETE等带请求体的请求
POST请求的核心在于构造请求体。HttpClient通过HttpContent的各个派生类来承载不同类型的body。最常见的是提交JSON数据，用StringContent配合正确的Content-Type，或者直接用扩展方法PostAsJsonAsync：
using System.Net.Http;
using System.Net.Http.Json;
using System.Text;
using System.Threading.Tasks;
public class OrderService
{
private static readonly HttpClient _client = new HttpClient();
// 方式一：手动构造JSON字符串
public async Task CreateOrderManuallyAsync()
{
string json = "{\"productId\":1001,\"quantity\":2}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
HttpResponseMessage resp = await _client.PostAsync("https://api.ipipp.com/orders", content);
resp.EnsureSuccessStatusCode();
}
// 方式二：使用扩展方法，自动序列化对象
public async Task<HttpResponseMessage> CreateOrderAsync(Order order)
{
return await _client.PostAsJsonAsync("https://api.ipipp.com/orders", order);
}
}
public class Order
{
public int ProductId { get; set; }
public int Quantity { get; set; }如果接口要求提交表单数据，也就是Content-Type为application/x-www-form-urlencoded的场景，就要用FormUrlEncodedContent，传入一个键值对字典即可。如果要上传文件，则使用MultipartFormDataContent，把文件流包装成StreamContent再Add进去。各种Content类型各有分工，选对了类型，接口对接就成功了一半。
PUT和DELETE请求的用法与POST类似，分别对应PutAsync、PutAsJsonAsync和DeleteAsync方法。对于一些特殊场景，比如需要自定义请求头、指定HTTP版本或者使用PATCH方法，可以手工构造HttpRequestMessage，然后调用SendAsync统一发送，这种方式灵活性最高：
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
public class ApiClient
{
private static readonly HttpClient _client = new HttpClient();
public async Task<string> RequestWithTokenAsync(string url, string token)
{
var request = new HttpRequestMessage(HttpMethod.Get, url);
// 添加自定义请求头，比如身份验证Token
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
request.Headers.Add("X-Custom-Header", "customValue");
HttpResponseMessage response = await _client.SendAsync(request);
response.EnsureSuccessStatusCode();
return await response.Content.ReadAsStringAsync();
}
}生命周期管理、超时与进阶实践
回到前面提到的端口耗尽问题。每次new一个HttpClient并using释放，底层Socket会进入TIME_WAIT状态，默认要等约240秒才能彻底释放，高并发下端口很快就会被占光。正确做法有两种：一是声明为静态只读实例全局复用；二是在ASP.NET Core项目中使用IHttpClientFactory，它由框架管理连接池和DNS刷新，是官方推荐的最佳实践：
// 在Program.cs中注册
builder.Services.AddHttpClient("orderApi", c =>
{
c.BaseAddress = new Uri("https://api.ipipp.com/");
c.Timeout = TimeSpan.FromSeconds(10);
c.DefaultRequestHeaders.Add("Accept", "application/json");
});
// 在控制器或服务中通过注入使用
public class OrderController : ControllerBase
{
private readonly IHttpClientFactory _factory;
public OrderController(IHttpClientFactory factory)
{
_factory = factory;
}
public async Task<IActionResult> Get()
{
var client = _factory.CreateClient("orderApi");
string result = await client.GetStringAsync("orders/1001");
return Ok(result);
}
}关于超时控制，HttpClient提供了Timeout属性，默认是100秒，超时会抛出TaskCanceledException。注意一旦设置就是全局生效，无法针对单个请求单独调整。如果需要每个请求不同的超时时间，要使用CancelAfter的CancellationTokenSource，在调用各方法时把token传进去，这样控制粒度更细。
最后提几个实用的细节：BaseAddress属性可以设置基础地址，之后传相对路径即可，方便统一管理API域名；DefaultRequestHeaders可以设置全局默认请求头；处理大文件下载时建议用HttpCompletionOption.ResponseHeadersRead参数，让响应体按需流式读取而不是一次性缓冲到内存；日志方面可以注册自定义的HttpMessageHandler来记录每次请求响应的明细，方便排查线上问题。掌握这些要点之后，用HttpClient对接任何HTTP接口都能游刃有余。
HttpClientC# HTTP请求异步编程修改时间：2026-09-03 06:48:35