HttpClient 必须复用实例而非每次 new，否则导致端口耗尽和 SocketException；应注册为 Singleton 或全局静态；PostAsync 需匹配 Content-Type 与序列化方式；严禁同步阻塞调用；调试优先检查复用、await、Content-Type 和代理/证书问题。
用 HttpClient 发送请求前必须复用实例
直接 new HttpClient() 一次就丢，是 .NET 中最隐蔽的资源泄漏源。它底层持有连接池和 DNS 缓存，频繁新建会快速耗尽端口、触发 SocketException: Too many open files 或超时堆积。
正确做法是全局单例或依赖注入注册为 Scoped/Singleton：
// 推荐：在 Program.cs 中注册 builder.Services.AddHttpClient<MyApiClient>(); <p>// 或手动管理生命周期（如控制台应用） static readonly HttpClient sharedClient = new HttpClient();
- 不要在方法内写
using var client = new HttpClient()—— 这会提前释放连接池 - 若需自定义配置（如超时、头信息），用
IHttpClientFactory创建命名客户端，而非每次 new - .NET 6+ 默认启用 HTTP/2，某些老旧服务可能拒绝连接，可显式降级：
client.DefaultRequestHeaders.ConnectionClose = true;
PostAsync 传参不生效？检查 Content-Type 和序列化方式
常见现象：后端收不到 body，或收到空对象。根本原因不是 C# 发不出数据，而是 Content-Type 与实际 payload 格式不匹配。
示例对比：
// ❌ 错误：字符串内容 + JSON 头，但没真正序列化
var content = new StringContent("{ \"name\":\"a\" }", Encoding.UTF8, "application/json");
await client.PostAsync(url, content);
<p>// ✅ 正确：用 JsonContent（.NET 5+）或手动序列化
var json = JsonSerializer.Serialize(new { name = "a" });
var content = new StringContent(json, Encoding.UTF8, "application/json");</p><p>// 更推荐（.NET 5+）：
var content = JsonContent.Create(new { name = "a" });
- 传表单数据用
FormUrlEncodedContent，对应application/x-www-form-urlencoded - 传文件用
MultipartFormDataContent，别直接把 byte[] 塞进 StringContent - 如果后端是 ASP.NET Core，且接收
[FromBody]，必须确保前端发的是合法 JSON 且 header 匹配
同步阻塞调用 GetResult() 或 .Result 极易死锁
在 UI 线程（WinForms/WPF）或 ASP.NET 同步上下文里，直接调用 task.Result 或 task.GetAwaiter().GetResult()，大概率卡死。这不是“慢”，是彻底死锁 —— await 需要回到原上下文，而你正占着它等结果。
唯一安全的同步场景是控制台主函数（无同步上下文），但也不推荐。
- ASP.NET Core 中必须用
await，Controller Action 标记async Task<IActionResult> - WinForms 中，在事件处理里用
async void Button_Click是危险的，应改为async Task并用ConfigureAwait(false)避免捕获上下文 - 若真无法改异步（如旧库接口），改用
Task.Run(() => client.GetAsync(url)).Result绕过上下文，但这是权宜之计，性能差
证书错误、代理、重定向失败？先关掉默认行为再排查
开发时遇到 HttpRequestException: The SSL connection could not be established 或莫名 407/302，往往不是代码问题，而是 HttpClient 的默认策略太“智能”。
临时绕过验证（仅限开发）：
var handler = new HttpClientHandler
{
ServerCertificateCustomValidationCallback = (m, c, ch, e) => true,
UseProxy = false // 关闭系统代理，排除 Fiddler/Charles 干扰
};
var client = new HttpClient(handler);
- 生产环境绝不能设
ServerCertificateCustomValidationCallback为true，应安装正确证书或更新根证书 - 重定向失败常见于 POST 后 302：默认
AllowAutoRedirect = true会把 POST 变 GET，后端收不到 body；需手动处理重定向或设handler.AllowAutoRedirect = false - Linux 容器中缺 CA 证书会导致 HTTPS 失败，需在 Dockerfile 中安装
ca-certificates
HTTP 请求本身简单，但 HttpClient 的生命周期、线程上下文、SSL 策略、编码匹配这四点，任何一个出偏差都会让请求表现得“完全不可预测”。调试时优先确认实例是否复用、是否 await、Content-Type 是否对得上、有没有被代理或证书拦截 —— 这四步覆盖了 90% 的线上报错。
