必须用 FormUrlEncodedContent 发送 POST 表单数据，因其自动 URL 编码、正确设置 Content-Type 头，避免乱码和解析错误；HttpClient 应复用而非每次 new，推荐 static readonly 实例或 HttpClientFactory。
直接用 HttpClient 配合 FormUrlEncodedContent 发送 POST 表单数据是最稳妥、最常用的方式，别碰 WebClient 或手动拼接 string 再转 byte[] —— 容易乱码、漏编码、不兼容空格和特殊字符。
为什么必须用 FormUrlEncodedContent 而不是自己拼字符串
手动拼 "key1=value1&key2=value2" 看似简单，但实际会踩三个坑：
-
value里有空格、中文、&、=时，不调用Uri.EscapeDataString()就会服务端收不到或解析错 - 不同 .NET 版本对默认编码处理不一致（比如 .NET Framework 默认用 UTF-8，但某些老服务期望 GB2312）
- 没设
Content-Type: application/x-www-form-urlencoded，部分后端框架（如 Spring Boot）直接拒绝请求
FormUrlEncodedContent 自动做 URL 编码 + 正确设置头，省心且符合规范。
HttpClient 实例要不要每次 new？
必须复用 HttpClient 实例，别在方法里 new HttpClient() —— 会导致 socket 耗尽、DNS 缓存失效、连接无法复用。
- 全局声明一个
static readonly HttpClient是最简单安全的做法（注意别乱改它的DefaultRequestHeaders） - 如果需要不同配置（比如带 token、超时不同），用
HttpClientFactory（.NET Core 2.1+）或封装成独立客户端类 - 别调用
client.Dispose()或using包裹——它不是短命对象
示例：
private static readonly HttpClient client = new HttpClient(); // 后续所有请求都用这个 client
传参时怎么处理 null、空字符串、嵌套对象
FormUrlEncodedContent 只接受 IDictionary<string, string>，所以：
-
null值要提前过滤掉，否则KeyValuePair的Value为null会抛ArgumentNullException - 空字符串
""是合法的，会被编码成key=，服务端通常能接收 - 嵌套对象（如
User.Address.City）不能自动展开——得手动展平：dict["User.Address.City"] = "Beijing" - 数组/集合需按表单习惯传多次同名 key：
dict.Add("ids", "1"); dict.Add("ids", "2")（FormUrlEncodedContent支持重复 key）
常见写法：
var data = new Dictionary<string, string>
{
["username"] = "admin",
["password"] = "p@ss w0rd", // 自动编码空格和符号
["tag"] = ""
};
var content = new FormUrlEncodedContent(data);
var response = await client.PostAsync("https://api.example.com/login", content);
遇到 400 或参数全为空，先查这三件事
这类问题八成不是代码逻辑错，而是协议细节没对齐：
- 抓包看发出的请求体是否真含
application/x-www-form-urlencoded，且 body 是类似username=admin&password=xxx的格式（不是 JSON） - 确认服务端接口文档是否真要表单提交——有些“POST 接口”其实要求
application/json，此时该用JsonContent - 检查服务端是否校验
Referer、Origin或要求特定User-Agent，这些虽不影响参数传递，但会导致 400/403
最容易被忽略的是：某些内网服务强制要求 Accept: */* 头，而 HttpClient 默认不发这个头，加一句 client.DefaultRequestHeaders.Accept.Clear(); client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("*/*")); 就行。
