应使用 HttpClient 而非 WebClient 或 HttpWebRequest；需全局单例或通过 IHttpClientFactory 管理；正确设置超时与 CancellationToken；POST JSON 优先用 PostAsJsonAsync；注意 DNS、代理及证书配置。
用 HttpClient 发请求，别用 WebClient 或 HttpWebRequest
现在标准做法就是 HttpClient，它线程安全、支持连接池、能复用 TCP 连接。老式 WebClient 已标记为“过时”，HttpWebRequest 则太底层、容易写错生命周期。
常见错误是每次发请求都 new 一个 HttpClient 实例——这会导致端口耗尽、DNS 不刷新、连接无法复用。正确做法是全局单例或用 IHttpClientFactory（ASP.NET Core 环境下）。
-
HttpClient应作为静态字段或通过 DI 注入，**不要在方法里 new - 如果要设置超时、Header 或 Cookie，用
DefaultRequestHeaders或构造HttpRequestMessage - GET 请求直接用
GetAsync；POST 提交 JSON 推荐用PostAsJsonAsync（需引用Microsoft.Extensions.Http）
HttpClient 的超时和取消怎么设才不卡死
默认超时是 100 秒，但这个值对多数 API 来说太长，而且它只控制整个请求周期，不区分 DNS、连接、发送、接收阶段。更危险的是：没配 CancellationToken 时，异步方法可能永远挂起。
真实场景中，你得同时控制两层超时：一个是 HttpClient.Timeout，另一个是传入的 CancellationToken（比如来自 ASP.NET Core 的 HttpContext.RequestAborted）。
- 设
Timeout前先确认是否真需要——有些长轮询或文件上传场景反而该设大一点 - 务必把
CancellationToken传给所有Async方法，例如await client.GetAsync(url, token) - 别用
Task.Wait()或.Result，会死锁；也不要用async void，异常无法捕获
JSON POST 总是 400 或空响应？检查 Content-Type 和序列化器
发 JSON 最常踩的坑不是地址或参数错，而是服务端根本没收到有效 body。典型现象是返回 400 Bad Request，或者日志里显示 body 为空、模型绑定失败。
原因往往出在两个地方：一是没设 Content-Type: application/json，二是用错了序列化方式（比如手动 JsonConvert.SerializeObject 后塞进 StringContent，却忘了指定编码）。
- 用
PostAsJsonAsync自动处理 Header 和 UTF-8 编码，比手写StringContent更稳 - 如果必须手拼 body，请用
new StringContent(json, Encoding.UTF8, "application/json") - 注意目标 API 是否要求
camelCase字段名——.NET 默认是 PascalCase，得配JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase
本地调试通，上线就超时？检查 DNS 缓存和代理配置
开发机跑得好好的，部署到服务器后 GetAsync 卡住或报 SocketException，大概率不是代码问题，而是网络环境差异。
Windows Server 默认启用 DNS 缓存，且某些内网环境强制走代理（哪怕你没配），而 HttpClient 默认不走系统代理（除非用默认构造函数）。另外，Linux 容器里还可能缺 CA 证书。
- 查 DNS 是否生效：
nslookup api.example.com；临时绕过缓存可改 hosts 或加UseProxy = false到HttpClientHandler - 显式禁用代理：
new HttpClientHandler { UseProxy = false } - Docker 镜像里跑 .NET 6+，记得装
ca-certificates（如apt-get update && apt-get install -y ca-certificates）
HTTP 请求的复杂性不在语法，而在它把你的代码直接暴露在操作系统网络栈、DNS、TLS 握手、代理策略这些看不见的环节里。少一个 CancellationToken，多一次 new HttpClient，或者漏掉一行 UseProxy = false，都可能让程序在线上安静地失败几个小时。
