C#怎么发起HTTP请求 C# HttpClient使用方法详解

推荐使用HttpClient发起HTTP请求,它线程安全、支持异步且可复用;应全局复用实例避免端口耗尽;GET用GetStringAsync,POST用StringContent发送JSON;需设置请求头、超时并手动处理响应状态与异常。

在C#中发起HTTP请求,推荐且现代的方式是使用 HttpClient。它线程安全、支持异步、可复用,是.NET Core/.NET 5+ 中的首选HTTP客户端。别再用已过时的 WebClient 或难管理的 HttpWebRequest

创建和复用 HttpClient 实例

HttpClient 设计上**不是一次性对象**,频繁 new 会导致端口耗尽(Socket Exhaustion)。正确做法是全局复用一个实例(如用 static 字段或依赖注入):

  • 在控制台或简单场景中:声明为 static readonly HttpClient
  • ASP.NET Core中:通过 services.AddHttpClient() 注册,由DI容器管理生命周期
  • 避免在方法内 using var client = new HttpClient()(除非明确短时、低频调用)

发起 GET 请求(字符串响应)

最常用场景:获取API返回的JSON或文本:

  • GetStringAsync(url) 直接得到字符串(自动处理UTF-8解码)
  • GetAsync(url) 获取 HttpResponseMessage,可检查状态码、读取内容流、自定义头等

示例:

var json = await client.GetStringAsync("https://api.example.com/users");

发送 POST 请求(JSON数据)

向API提交结构化数据,通常用JSON:

  • JsonSerializer.Serialize()(.NET Core 3.0+)或 System.Text.Json 序列化对象
  • 包装成 StringContent,指定 "application/json" 类型
  • 调用 PostAsync(url, content)

示例:

var data = new { Name = "张三", Age = 25 };
var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/users", content);

设置请求头、超时与错误处理

实际项目中需关注健壮性:

  • 通过 client.DefaultRequestHeaders 添加通用头,如 AuthorizationUser-Agent
  • 超时用 client.Timeout = TimeSpan.FromSeconds(10);(注意:不能设为无限,也不能在请求中动态改)
  • 务必检查 response.IsSuccessStatusCode;非2xx响应不会自动抛异常,需手动处理
  • try/catch 捕获 HttpRequestException(网络失败、DNS错误等)

基本上就这些。掌握这四点,就能覆盖95%的HTTP调用需求。不复杂但容易忽略复用和异常细节。