1. HttpClient基础概念与初始化HttpClient是.NET框架中用于发送HTTP请求和接收HTTP响应的核心类。它位于System.Net.Http命名空间支持HTTP/1.1和HTTP/2协议并提供了异步操作方法。1.1 创建HttpClient实例最佳实践是重用HttpClient实例而非频繁创建销毁。以下是推荐的初始化方式private static readonly HttpClient _httpClient new HttpClient() { BaseAddress new Uri(https://api.example.com), Timeout TimeSpan.FromSeconds(30) };关键配置参数说明BaseAddress设置基础地址后续请求可使用相对路径Timeout设置请求超时时间默认100秒DefaultRequestHeaders可添加公共请求头如User-Agent等警告避免使用using语句包裹HttpClient除非明确知道其生命周期很短。长期存活的HttpClient实例能更好地管理连接池。1.2 依赖注入配置在ASP.NET Core中推荐通过IHttpClientFactory管理services.AddHttpClient(DefaultClient, client { client.BaseAddress new Uri(https://api.example.com); client.DefaultRequestHeaders.Add(Accept, application/json); });2. 发送HTTP请求的多种方式2.1 GET请求实现基本GET请求示例public async Taskstring GetDataAsync(string endpoint) { HttpResponseMessage response await _httpClient.GetAsync(endpoint); response.EnsureSuccessStatusCode(); return await response.Content.ReadAsStringAsync(); }带查询参数的GET请求var query HttpUtility.ParseQueryString(string.Empty); query[page] 1; query[size] 10; string queryString query.ToString(); string fullUrl $users?{queryString}; var response await _httpClient.GetAsync(fullUrl);2.2 POST请求实现发送JSON数据var user new { Name John, Age 30 }; string json JsonSerializer.Serialize(user); var content new StringContent(json, Encoding.UTF8, application/json); var response await _httpClient.PostAsync(users, content);使用强类型对象public async TaskUser CreateUserAsync(User user) { var response await _httpClient.PostAsJsonAsync(users, user); response.EnsureSuccessStatusCode(); return await response.Content.ReadFromJsonAsyncUser(); }2.3 其他HTTP方法PUT请求示例await _httpClient.PutAsJsonAsync($users/{id}, updatedUser);DELETE请求示例await _httpClient.DeleteAsync($users/{id});PATCH请求需要单独安装Microsoft.AspNet.WebApi.Client包var patchDoc new JsonPatchDocumentUser(); patchDoc.Replace(u u.Name, New Name); var response await _httpClient.PatchAsync( $users/{id}, new StringContent( JsonConvert.SerializeObject(patchDoc), Encoding.UTF8, application/json-patchjson));3. 高级功能与配置3.1 请求重试策略使用Polly实现弹性策略var retryPolicy PolicyHttpResponseMessage .HandleHttpRequestException() .OrResult(r !r.IsSuccessStatusCode) .WaitAndRetryAsync(3, retryAttempt TimeSpan.FromSeconds(Math.Pow(2, retryAttempt))); var response await retryPolicy.ExecuteAsync(() _httpClient.GetAsync(unstable-api));3.2 处理大文件下载流式处理避免内存溢出public async Task DownloadFileAsync(string url, string savePath) { using var response await _httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead); await using var fs new FileStream(savePath, FileMode.Create); await response.Content.CopyToAsync(fs); }3.3 自定义消息处理器创建处理认证的DelegatingHandlerpublic class AuthHandler : DelegatingHandler { protected override async TaskHttpResponseMessage SendAsync( HttpRequestMessage request, CancellationToken cancellationToken) { request.Headers.Authorization new AuthenticationHeaderValue(Bearer, GetToken()); return await base.SendAsync(request, cancellationToken); } }注册自定义处理器services.AddHttpClient(AuthClient) .AddHttpMessageHandlerAuthHandler();4. 常见问题与解决方案4.1 性能优化技巧连接池管理设置ServicePointManager.DefaultConnectionLimit增加连接数对高频请求考虑使用Keep-Alive响应缓冲控制var response await _httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);取消长时间运行的请求var cts new CancellationTokenSource(TimeSpan.FromSeconds(30)); await _httpClient.GetAsync(url, cts.Token);4.2 错误处理模式综合错误处理示例try { var response await _httpClient.GetAsync(url); if(response.StatusCode HttpStatusCode.NotFound) { // 处理404 } else if(!response.IsSuccessStatusCode) { // 处理其他错误状态码 var errorContent await response.Content.ReadAsStringAsync(); throw new CustomApiException(response.StatusCode, errorContent); } return await response.Content.ReadFromJsonAsyncT(); } catch(HttpRequestException ex) when (ex.StatusCode.HasValue) { // 处理网络层错误 } catch(TaskCanceledException ex) { // 处理超时 }4.3 调试技巧记录请求详情var request new HttpRequestMessage(HttpMethod.Get, url); request.Headers.Add(X-Request-ID, Guid.NewGuid().ToString()); var response await _httpClient.SendAsync(request); LogRequest(request, response);使用Fiddler或Charles调试var handler new HttpClientHandler { Proxy new WebProxy(localhost, 8888), UseProxy true };5. 实际应用场景5.1 调用REST API典型API调用流程设置基础地址和认证头构造请求参数发送请求并验证响应反序列化响应内容错误处理和重试5.2 文件上传实现多部分表单上传using var content new MultipartFormDataContent(); var fileContent new StreamContent(File.OpenRead(test.jpg)); fileContent.Headers.ContentType MediaTypeHeaderValue.Parse(image/jpeg); content.Add(fileContent, file, test.jpg); content.Add(new StringContent(file description), description); var response await _httpClient.PostAsync(upload, content);5.3 服务间通信在微服务架构中的典型使用public class ProductService { private readonly HttpClient _httpClient; public ProductService(IHttpClientFactory factory) { _httpClient factory.CreateClient(ProductService); } public async TaskProduct GetProductAsync(int id) { var response await _httpClient.GetAsync($products/{id}); response.EnsureSuccessStatusCode(); return await response.Content.ReadFromJsonAsyncProduct(); } }6. 安全注意事项始终验证HTTPS证书var handler new HttpClientHandler { ServerCertificateCustomValidationCallback (message, cert, chain, errors) errors SslPolicyErrors.None };敏感信息保护不要将API密钥硬编码在代码中使用Configuration或密钥管理服务考虑使用HttpClient的拦截器自动添加认证头输入验证验证所有URL和参数对用户提供的输入进行编码设置合理的超时时间防止DoS攻击7. 性能监控与指标添加诊断日志services.AddHttpClient(MetricsClient) .AddPolicyHandler(Policy.TimeoutAsyncHttpResponseMessage(10)) .AddHttpMessageHandlerLoggingHandler();关键指标监控请求成功率平均响应时间超时和重试次数连接池使用情况使用Application Insights集成services.AddApplicationInsightsTelemetry(); services.AddHttpClient(TrackedClient) .AddHttpMessageHandlerTelemetryHandler();在实际项目中我经常发现开发者容易忽视连接泄漏问题。建议定期检查HttpClient的使用情况特别是在长时间运行的应用中。一个实用的技巧是为不同的业务领域创建独立的HttpClient实例这样可以更好地隔离配置和资源管理。