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 - 不安全的做法：使用字符串插值如
$"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接口的关键所在。
