.NET中HttpClient发送POST请求教程

首先复用HttpClient实例以避免资源泄漏，再将数据序列化为JSON并封装为StringContent，然后调用PostAsync发送请求，最后检查响应状态并处理结果或异常。推荐通过依赖注入注册HttpClient，使用System.Text.Json序列化，设置超时和try-catch增强健壮性。关键在于实例复用、正确序列化与错误处理。

在.NET中使用HttpClient发送POST请求是常见的网络操作，适用于与Web API交互、提交表单数据等场景。正确使用HttpClient不仅能提升性能，还能避免资源泄漏。以下是具体步骤和示例。

1. 创建HttpClient实例

推荐通过依赖注入或使用静态实例来管理HttpClient，避免频繁创建导致的Socket资源耗尽问题。

例如，在Program.cs或服务配置中注册：

builder.Services.AddHttpClient();

或手动创建静态实例：

private static readonly HttpClient client = new HttpClient();

2. 准备POST请求的数据

根据目标API要求，将数据序列化为JSON或其他格式。

var data = new { Name = "张三", Age = 25 };
var json = System.Text.Json.JsonSerializer.Serialize(data);
var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json");

StringContent用于封装请求体，并指定内容类型。

3. 发送POST请求并处理响应

调用PostAsync方法发送请求，然后读取响应结果。

var response = await client.PostAsync("https://api.example.com/users", content);

if (response.IsSuccessStatusCode)
{
    var responseBody = await response.Content.ReadAsStringAsync();
    // 处理返回结果
}
else
{
    // 处理错误状态
}

4. 错误处理与超时设置（可选但推荐）

合理配置超时和异常捕获机制，提高程序健壮性。

• 设置超时：client.Timeout = TimeSpan.FromSeconds(30);
• 包裹请求代码在try-catch中，捕获HttpRequestException等网络异常

try
{
    var response = await client.PostAsync("https://api.example.com/users", content);
    response.EnsureSuccessStatusCode(); // 抛出异常如果状态码不是成功
}
catch (HttpRequestException ex)
{
    // 记录日志或重试
}

基本上就这些。只要按步骤准备数据、构建请求、发送并处理响应，就能稳定地使用HttpClient发送POST请求。关键是复用实例、正确序列化数据，并做好异常处理。不复杂但容易忽略细节。