.NET如何使用HttpClient发送POST请求

.NET 中使用 HttpClient 发送 POST 请求非常常见，尤其是在调用 Web API 时。关键在于构造正确的请求内容并正确处理响应。以下是具体步骤和示例。

创建 HttpClient 实例

建议将 HttpClient 作为单例或使用 IHttpClientFactory 来避免资源泄漏。在实际项目中不要每次都 new HttpClient。

builder.Services.AddHttpClient();

然后通过依赖注入获取实例。

发送 JSON 格式的 POST 请求

大多数 API 要求发送 JSON 数据。可以使用 JsonContent 或手动序列化。

var data = new { Name = "张三", Age = 25 };
var jsonContent = JsonContent.Create(data);
using var client = new HttpClient();
var response = await client.PostAsync("https://api.example.com/users", jsonContent);
if (response.IsSuccessStatusCode)
{
    var responseBody = await response.Content.ReadAsStringAsync();
    Console.WriteLine(responseBody);
}

这里 JsonContent.Create 会自动设置 Content-Type 为 application/json。

发送表单数据（x-www-form-urlencoded）

某些接口需要发送表单数据，比如登录请求。

var formData = new Dictionary<string, string>
{
    { "username", "admin" },
    { "password", "123456" }
};
var content = new FormUrlEncodedContent(formData);
var response = await client.PostAsync("https://example.com/login", content);

这种格式的请求头会被自动设为 application/x-www-form-urlencoded。

处理响应和异常

网络请求可能失败，必须做好异常处理和状态码判断。

try
{
    var response = await client.PostAsync(url, content);
    response.EnsureSuccessStatusCode(); // 抛出非2xx状态的异常
    var result = await response.Content.ReadAsStringAsync();
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"请求失败: {ex.Message}");
}

也可以用 response.IsSuccessStatusCode 判断是否成功，更灵活。