httpClient是C#中用于HTTP通信的核心类，支持GET、POST等请求及jsON数据处理；推荐通过IHttpClientFactory管理实例以避免资源问题，并合理设置超时与释放资源。
HttpClient 是 C# 中用于发送 HTTP 请求和接收 HTTP 响应的类，位于 System.net.Http 命名空间中。它是现代 .NET 应用程序中进行 HTTP 通信的推荐方式，支持 GET、POST、PUT、delete 等请求方法，并能处理 json、表单数据、文件上传等多种内容类型。
基本使用方式
HttpClient 可以通过构造函数创建实例，但更推荐将其作为服务注册到依赖注入容器中（如 ASP.NET Core），避免资源泄漏和端口耗尽问题。
// 创建 HttpClient 实例（示例）
using var client = new HttpClient();
发送 GET 请求并读取响应
GET 请求常用于获取数据。使用 GetAsync 方法发送请求，再通过 EnsureSuccessStatusCode 和 ReadAsStringAsync 处理响应。
try { using var client = new HttpClient(); HttpResponseMessage response = await client.GetAsync("https://api.example.com/data"); response.EnsureSuccessStatusCode(); // 抛出异常如果状态码不是 2xx string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } catch (HttpRequestException e) { Console.WriteLine($"请求失败: {e.Message}"); }
发送 POST 请求（JSON 数据）
发送 JSON 数据时，需将对象序列化为字符串，并设置正确的 Content-Type 请求头（如 application/json）。
using var client = new HttpClient(); var data = new { Name = "Alice", Age = 30 }; string json = System.Text.Json.JsonSerializer.Serialize(data); var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json"); HttpResponseMessage response = await client.PostAsync("https://api.example.com/users", content); if (response.IsSuccessStatusCode) { string result = await response.Content.ReadAsStringAsync(); Console.WriteLine("创建成功: " + result); } else { Console.WriteLine("错误: " + response.StatusCode); }
处理响应状态码与头部信息
除了响应体，还可以检查状态码、响应头等信息，用于调试或条件判断。
HttpResponseMessage response = await client.GetAsync("https://httpbin.org/status/404"); Console.WriteLine($"状态码: {response.StatusCode}"); Console.WriteLine($"状态行: {response.ReasonPhrase}"); foreach (var header in response.Headers) { Console.WriteLine($"{header.Key}: {string.Join(", ", header.Value)}"); }
最佳实践与注意事项
- 不要频繁创建 HttpClient 实例：HttpClient 设计为可重用，频繁 new 可能导致 socket 耗尽。在应用生命周期内共享一个实例，或使用 IHttpClientFactory。
- 使用 IHttpClientFactory（推荐）：在 ASP.NET Core 中通过依赖注入注册 HttpClient，自动管理底层 HttpMessageHandler 的复用。
- 设置超时时间：可通过 Timeout 属性控制请求最长等待时间。
- 释放资源：若手动创建 HttpClient，务必使用 using 或调用 Dispose()。
基本上就这些。HttpClient 功能强大且灵活，配合 async/await 能高效处理网络请求，是 C# 开发中与 Web API 交互的核心工具。