HttpClient.PostAsync发送XML时需显式构造StringContent或ByteArrayContent并指定"application/xml"，否则默认为text/plain；含中文须用Encoding.UTF8；大文件应使用StreamContent避免内存暴涨。
HttpClient.PostAsync 发送 XML 时 Content-Type 不生效？
直接用 PostAsync 传字符串或字节数组，默认走 text/plain，application/xml 不会自动设置——这是最常踩的坑。
必须显式构造 StringContent 或 ByteArrayContent，并传入 "application/xml" 类型：
var xml = "<root><id>123</id></root>";
var content = new StringContent(xml, Encoding.UTF8, "application/xml");
await client.PostAsync("https://api.example.com/data", content);
- 别用
PostAsync(uri, new StringContent(...))却漏掉第三个参数，否则类型变成text/plain;charset=utf-8 - 如果 XML 含中文或特殊字符，务必指定
Encoding.UTF8；.NET 6 默认不带 BOM，但某些老服务会因缺少 BOM 解析失败 -
StringContent内部会自动加charset=utf-8，不需要手动拼接"application/xml; charset=utf-8"
XML 中有命名空间或前缀，发送后服务端解析失败
不是 HttpClient 的问题，而是 XML 序列化时没处理好命名空间声明。.NET 6 默认序列化器（XmlSerializer）对空命名空间、默认前缀（xmlns=""）行为敏感，容易导致服务端校验失败。
建议绕过 XmlSerializer，手写或用 XDocument 构建干净 XML：
var doc = new XDocument(
new XElement("root",
new XAttribute(XNamespace.Xmlns + "ns", "http://example.com/ns"),
new XElement("ns:id", "123")
)
);
var xmlString = doc.ToString(SaveOptions.DisableFormatting); // 避免换行缩进干扰
var content = new StringContent(xmlString, Encoding.UTF8, "application/xml");
- 避免用
XmlSerializer直接序列化 POCO：它可能插入意外的xmlns:xsi、xsi:type等属性 - 若必须用
XmlSerializer，提前设置XmlSerializerNamespaces清空默认命名空间 - 用
SaveOptions.DisableFormatting防止换行和空格被当成文本节点，某些严格 XML 解析器会报错
POST XML 后返回 415 Unsupported Media Type
错误不是出在请求体，而是服务端没收到正确的 Content-Type 请求头——常见于反向代理（如 Nginx、IIS）或网关拦截了自定义头。
检查实际发出的请求头是否含 Content-Type: application/xml，可用 Fiddler、Wireshark 或 HttpClient 的 DefaultRequestHeaders 日志确认：
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/xml"));
// 注意：这只是告诉服务端“我接受什么”，不影响请求体类型
-
Accept头和Content-Type是两回事，别混淆；415 错误只跟后者有关 - 某些云 API 网关（如 Azure APIM）默认过滤非标准
Content-Type，需在策略中显式放行application/xml - 如果服务端是 ASP.NET Core，检查其
Startup.cs或Program.cs是否注册了 XML 输入格式器：options.InputFormatters.Insert(0, new XmlDataContractSerializerInputFormatter(...))
大 XML（>1MB）发送超时或内存暴涨
StringContent 会把整个 XML 加载进内存，再转成 byte[]，对大文件很危险。.NET 6 支持流式发送，但必须自己构造 HttpContent 子类或用 StreamContent。
推荐用 FileStream 或 MemoryStream 包装 XML 流，避免一次性加载：
using var stream = new FileStream("data.xml", FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true);
var content = new StreamContent(stream);
content.Headers.ContentType = new MediaTypeHeaderValue("application/xml");
- 别用
File.ReadAllBytes+ByteArrayContent，它同样全量加载到内存 -
StreamContent不支持同步读取，确保调用PostAsync是 await 的，且底层Stream支持异步 - 如果 XML 来自生成逻辑（非文件），用
XmlWriter写入MemoryStream比拼字符串更省内存、更安全
xml version="1.0" 的声明？这些细节往往藏在对方文档角落，或者得抓包比对成功请求才能确认。 
