最稳妥的 POST 请求应使用 HttpClient：表单数据用 FormUrlEncodedContent 自动编码，JSON 用 System.Text.Json 序列化并设 UTF-8 和 application/json，文件上传用 MultipartFormDataContent 管理流生命周期；务必复用 HttpClient 实例、设置超时、处理证书与异步上下文。
直接用 HttpClient 发送 POST 请求最稳妥，别碰过时的 WebClient 或手动拼 HttpWebRequest —— 容易漏头、乱编码、不支持异步取消，且 .NET Core / .NET 5+ 已明确推荐 HttpClient 为唯一首选。
怎么发最简 POST（表单数据）
多数接口接收 application/x-www-form-urlencoded，比如登录、提交表单。别手拼字符串，用 FormUrlEncodedContent 自动处理编码和键值对：
var client = new HttpClient();
var data = new Dictionary<string, string>
{
{ "username", "admin" },
{ "password", "123456" }
};
var content = new FormUrlEncodedContent(data);
var response = await client.PostAsync("https://api.example.com/login", content);
var body = await response.Content.ReadAsStringAsync();
- 必须
await，否则可能死锁（尤其 WinForms/WPF 同步上下文里） -
FormUrlEncodedContent会自动设Content-Type头，别手动覆盖 - 如果服务端要求
charset=utf-8，它默认已带；但某些老旧系统要charset=gb2312，就得自己构造StringContent
怎么发 JSON POST（主流 API 场景）
现代 REST API 几乎都用 application/json。别用 JsonConvert.SerializeObject 拼字符串再包 StringContent —— 容易错失序列化配置（如日期格式、空值忽略）：
var client = new HttpClient();
var payload = new { name = "张三", age = 28 };
var json = JsonSerializer.Serialize(payload); // .NET 5+ 原生支持
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/users", content);
- .NET Core 3.0+ 优先用
System.Text.Json，比Newtonsoft.Json更快更轻，且默认 UTF-8 - 若必须用
Newtonsoft.Json，确保调用JsonConvert.SerializeObject(obj, new JsonSerializerSettings { ... })显式控制行为 - 别漏设
Content-Type，否则服务端可能拒收或解析成字符串
POST 时怎么传文件（multipart/form-data）
上传文件不能用 FormUrlEncodedContent，得用 MultipartFormDataContent。注意字段顺序、文件名、流生命周期：
var client = new HttpClient();
var multipart = new MultipartFormDataContent();
// 普通字段
multipart.Add(new StringContent("report_2024", Encoding.UTF8), "title");
// 文件字段（注意：FileStream 必须保持打开直到请求结束）
using var fileStream = File.OpenRead(@"C:\data.pdf");
multipart.Add(new StreamContent(fileStream), "file", "data.pdf");
var response = await client.PostAsync("https://api.example.com/upload", multipart);
-
StreamContent不会自动关闭流，务必确保fileStream在PostAsync完成后再释放（用using包住整个请求块，或手动Dispose） - 第二个参数
"file"是表单字段名（<input name="file">），第三个是服务端看到的文件名，二者常不同 - 大文件上传建议加
CancellationToken和进度回调（需自定义HttpContent子类，标准库不直接支持）
常见坑与必须检查项
90% 的 POST 失败不是代码写错，而是环境或配置疏忽：
-
HttpClient实例应复用（全局单例或 DI 注入），别每次请求都new—— 否则触发端口耗尽（SocketException: Too many open files） - 证书错误（
HttpRequestException: The SSL connection could not be established）：开发时可临时加client.DefaultRequestHeaders.Add("User-Agent", "...")排查是否被 WAF 拦截；生产环境必须修复证书链，别用ServerCertificateCustomValidationCallback直接返回true - 超时默认是 100 秒，但很多 API 要求 30 秒内响应，记得设
client.Timeout = TimeSpan.FromSeconds(30) - 跨域请求（CORS）失败？那是浏览器拦的，
HttpClient本身不走 CORS 检查 —— 别在服务端代码里瞎调AllowAnyOrigin()，先确认你是在服务端调用还是前端 JS 调用
真正麻烦的是混合场景：比如 POST JSON 同时带 JWT Bearer Token、需要重试机制、还要对接内部网关做签名。这些没法靠一个 PostAsync 解决，得拆成拦截器、策略、委托工厂 —— 但前提是，先确保基础 POST 能稳定发出。
