C#怎么发送HTTP请求 C#如何使用HttpClient调用REST API接口获取数据【网络】

C#如何发送HTTP请求？详解HttpClient调用REST API接口获取数据的最佳实践【网络编程】

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

HttpClient 必须复用，切忌每次新建实例

许多C#开发者初次使用HttpClient时，常犯的一个错误是在方法内部直接 new HttpClient()。这种做法看似便捷，实则隐患巨大。频繁创建HttpClient实例会导致底层TCP套接字端口无法及时释放，最终可能引发端口耗尽和 SocketException 异常。此外，每次新建连接都无法复用DNS解析缓存和连接池，严重拖累应用程序性能。

那么，如何正确复用HttpClient呢？在 .NET Core 2.1 及更高版本中，最佳方案是通过依赖注入，使用 IServiceCollection.AddHttpClient() 将其注册为单例或作用域服务。对于控制台应用或简单脚本，一个有效的方法是将其声明为静态只读字段。

• 典型的错误示例：在方法内部使用 var client = new HttpClient(); —— 这会导致每次调用都创建新实例。
• 推荐的静态复用方案：private static readonly HttpClient _client = new HttpClient();
• 重要提醒：除非你完全确定该实例的生命周期已结束且后续不再使用，否则不要手动调用 _client.Dispose()，应交由框架管理其生命周期。

GET请求参数编码：务必使用Uri.EscapeDataString或QueryHelpers

构建GET请求的查询字符串是另一个高频错误点。直接进行字符串拼接，例如手动编写 ?key=value&key2=value2，当参数值包含空格、中文、&、=等特殊字符时，会破坏URL结构，导致服务端返回400错误或解析失败。特别是当参数来自用户输入或数据库时，风险极高。

因此，务必避免手动拼接。推荐使用 UriBuilder 配合 QueryHelpers（需引用 Microsoft.AspNetCore.WebUtilities NuGet包）来安全构建URL。

• 推荐的安全构建方式：

  var uri = new UriBuilder("https://api.example.com/users");
  uri.Query = QueryHelpers.AddQueryString("", new Dictionary {
      ["name"] = "张三",
      ["page"] = "1"
  });
  var response = await _client.GetAsync(uri.ToString());

• 不安全的做法：使用字符串插值如 $"https://...?name={name}"。这会导致中文字符乱码，且参数中的 & 符号可能截断查询字符串，引发未知问题。

POST JSON数据：必须设置Content-Type并使用StringContent

发送POST请求提交JSON数据时，常见的疏忽是忘记设置正确的请求头。许多新手会这样写：client.PostAsync(url, new StringContent(json, Encoding.UTF8))。虽然请求体是JSON文本，但缺少 Content-Type: application/json 头信息，服务端无法正确解析，通常返回415 Unsupported Media Type错误。

• 正确的完整代码示例：

  var json = JsonSerializer.Serialize(new { username = "alice", pwd = "123" });
  var content = new StringContent(json, Encoding.UTF8, "application/json");
  var response = await _client.PostAsync("https://api.example.com/login", content);

• 需要警惕的混淆：切勿使用 FormUrlEncodedContent 发送JSON。该类专为 application/x-www-form-urlencoded 格式设计，会将整个JSON字符串当作一个字段值编码，导致服务端无法解析出预期结构。
• 补充说明：若调用的API需要Bearer Token认证，记得在发送请求前设置请求头：_client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

异步方法必须使用await，避免.Result或.Wait()

在异步编程中，阻塞异步任务是严重错误。尤其在ASP.NET Core这类拥有同步上下文（SynchronizationContext）的Web应用环境中，在控制器中调用 task.Result 或 .Wait() 极易导致线程死锁，使应用无响应。HttpClient 的核心方法如 GetAsync、PostAsync 均为真正的异步操作，必须使用 await 关键字。

• 绝对要避免的写法：var res = client.GetAsync(url).Result; 或使用 .Wait()。
• 在ASP.NET Core控制器中的正确做法：将Action方法标记为 async Task，并在方法体内使用 await。
• 在控制台程序中的处理：对于C# 7.1及以上版本，可使用 static async Task Main(string[] args) 作为入口点。若需在其他地方同步等待，可考虑使用 await MainAsync().ConfigureAwait(false) 来避免潜在的上下文问题。

总而言之，使用C#的HttpClient发送HTTP请求，真正的挑战往往不在于“如何发出请求”，而在于背后的连接复用策略、参数编码的安全性以及异步流程的妥善控制。这三个核心要点若未处理得当，接口在测试阶段可能表现正常，一旦上线，间歇性失败、响应缓慢乃至内存消耗持续上涨等问题便会接踵而至。这正是高效、稳定调用REST API接口的关键所在。