HttpClient.PostAsync传参需手动构造HttpContent并设正确Content-Type：JSON用JsonContent或StringContent配application/json，表单用FormUrlEncodedContent，文件上传用MultipartFormDataContent；务必await且using管理生命周期；失败时优先查响应体与Headers而非仅状态码。
HttpClient.PostAsync 传参要选对 Content 类型
发送 POST 请求的核心不是“怎么发”，而是“发什么格式”。HttpClient.PostAsync 本身不处理参数序列化，必须手动构造 HttpContent。常见错误是直接传对象或字符串却不指定 Content-Type，导致后端收不到数据或解析失败。
-
application/json：用JsonContent.Create(obj)（.NET 5+），或手动new StringContent(JsonSerializer.Serialize(obj), Encoding.UTF8, "application/json") -
application/x-www-form-urlencoded：用new FormUrlEncodedContent(new Dictionary<string string> { ["key"] = "value" })</string> - 纯文本或 XML：用
new StringContent("raw", Encoding.UTF8, "text/plain")或对应 MIME 类型
别忘了 await，也别忘了 using
HttpClient 是可释放资源，且 PostAsync 是异步方法。漏掉 await 会导致任务未完成就返回；不加 using 或复用不当会引发 socket 耗尽（尤其在高并发 Web 应用中）。
using var client = new HttpClient();
var content = new StringContent("{\"name\":\"test\"}", Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/users", content);
response.EnsureSuccessStatusCode(); // 主动检查状态码
401/403/500 不是代码错了，先看响应体和 Header
很多“POST 失败”问题其实和请求方法无关，而是鉴权、跨域或服务端逻辑导致的。直接看 response.StatusCode 不够，要读取 response.Content.ReadAsStringAsync() 和 response.Headers：
- 返回 401 但没
WWW-AuthenticateHeader → 可能 token 格式错（如少了Bearer前缀） - 返回 400 且响应体是 JSON 错误信息 → 检查字段名大小写、必填项、日期格式是否匹配 API 文档
- 返回 500 且
X-Request-ID存在 → 把这个 ID 给后端查日志，别自己猜
上传文件要用 MultipartFormDataContent
表单带文件时不能用 FormUrlEncodedContent，必须用 MultipartFormDataContent。它会自动生成 boundary，并正确设置每个 part 的 Content-Disposition 和类型。
using var client = new HttpClient();
var content = new MultipartFormDataContent();
content.Add(new StringContent("John"), "name");
content.Add(new ByteArrayContent(File.ReadAllBytes("avatar.jpg")), "file", "avatar.jpg");
var response = await client.PostAsync("https://api.example.com/upload", content);
注意：ByteArrayContent 不会自动探测 MIME 类型，图片传错成 text/plain 很常见，必要时手动设置 Headers.ContentType。
