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

使用HttpClient发送POST请求需注意资源管理和异常处理。首先通过AddHttpClient配置服务并依赖注入获取实例，避免频繁创建。发送JSON数据时用JsonContent.Create自动设置application/json类型，示例：var data = new { Name = "张三", Age = 25 }; var content = JsonContent.Create(data); 发送表单数据则用FormUrlEncodedContent，适用于x-www-form-urlencoded格式，如登录请求：var formData = new Dictionary { { "username", "admin" }, { "password", "123456" } }; var content = new FormUrlEncodedContent(formData); 处理响应时应结合try-catch捕获HttpRequestException，并通过EnsureSuccessStatusCode或IsSuccessStatusCode判断结果，确保请求成功。正确选择内容类型、管理资源和处理错误是稳定调用Web API的关键。

.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。

Digram

让Figma更好用的AI神器

下载

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

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

var formData = new Dictionary
{
    { "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 判断是否成功，更灵活。