在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添加通用头,如
Authorization、
User-Agent超时用
client.Timeout = TimeSpan.FromSeconds(10);(注意:不能设为无限,也不能在请求中动态改) 务必检查
response.IsSuccessStatusCode;非2xx响应不会自动抛异常,需手动处理 用
try/catch捕获
HttpRequestException(网络失败、DNS错误等)
基本上就这些。掌握这四点,就能覆盖95%的HTTP调用需求。不复杂但容易忽略复用和异常细节。
