application/xml是什么 如何直接POST XML字符串

application/xml 是标识纯 XML 格式数据的标准 MIME 类型,用于 HTTP 请求/响应中明确内容类型;必须显式设置 Content-Type 头,否则后端可能无法正确解析 XML 字符串。

application/xml 是什么

application/xml 是一个标准的 MIME 类型,用于标识 H

TTP 请求或响应中传输的内容是纯 XML 格式数据,且不依赖于特定应用语义(区别于 text/xml,后者已基本被弃用,且在字符编码处理上更宽松)。服务器通过这个 Content-Type 头判断如何解析请求体,客户端也据此决定是否启用 XML 解析器。

POST XML 字符串时必须设置 Content-Type

如果不显式指定 Content-Type: application/xml,多数后端框架(如 Spring Boot、Django REST、Express + body-parser)会默认按 application/x-www-form-urlencodedtext/plain 解析,导致 req.body 为空或变成乱码字符串,而非可解析的 XML DOM 或对象。

  • Python requests:必须传 headers={'Content-Type': 'application/xml'}
  • JavaScript fetchheaders: {'Content-Type': 'application/xml'} 不可省略
  • cURL:用 -H "Content-Type: application/xml" 显式声明
  • Postman:在 Body → raw 下拉菜单中选 “XML (application/xml)”(它会自动加 header)

直接 POST XML 字符串的常见写法

关键是把 XML 内容作为原始字符串传入请求体,不进行 JSON 封装、不 URL 编码、不拼 query 参数。以下为典型示例:

curl -X POST https://api.example.com/data \
  -H "Content-Type: application/xml" \
  -d '123Alice'
import requests
xml_data = "book2"
response = requests.post(
    "https://api.example.com/order",
    data=xml_data,  # 注意:不是 json=...,也不是 files=...
    headers={"Content-Type": "application/xml"}
)
fetch("https://api.example.com/submit", {
  method: "POST",
  headers: {
    "Content-Type": "application/xml"
  },
  body: "Hello"
});

容易忽略的细节和坑

XML 对编码和格式敏感,几个关键点常导致 400 或解析失败:

  • XML 字符串必须是良构(well-formed):标签闭合、嵌套正确、无非法字符(如未转义的 &
  • 如果 XML 声明含编码(如 ),整个请求体必须实际使用该编码发送;推荐统一用 UTF-8 并省略声明,避免 header 与内容不一致
  • 某些服务要求 XML 根节点名称匹配预期(如只接受 ),错用会返回 406 或 422
  • Node.js 的 http.request 或低层 API 需手动设置 req.setHeader('Content-Type', 'application/xml'),且 req.end(xmlString) 前不能调用 JSON.stringify

最稳妥的做法:先用在线 XML 校验器验证字符串,再确认服务文档是否要求额外 header(如 Accept: application/xml),最后抓包看发出的请求体和 header 是否完全符合预期。