XML 解析错误：not well-formed 的烦恼

最近在搞HTML5解析XML的时候老是遇到not well-formed的错误，搞得我很头疼。

弯道超车。 先来看， 你得了解XML声明必须要是文档第一行第一个字符，前面不能有任意空白、BOM或隐藏字符。哪怕开头更多一个\uFEFF也会报错。我之前就是这是因为当前这个原因报错的，我的代码里有乱七八糟的看不见的字符。

检查 XML 声明和编码

HTML5 中用 DOMParser 解析 XML 报 not well-formed 错误， 基本能够断定是 XML 内容本身不符合法规，而不是浏览器或 API 有问题，是个狼人。。

在理。 最常见的原因是服务端返回的 XML 声明了编码， 但实际传输的内容是 GBK 或其他编码，或者 HTTP 响应头里的 Content-Type 声明了错误编码。比如说服务端返回的是 GBK 编码，但是 XML 声明里写的是 UTF-8，这就会引起解析错误。

const decoder = new TextDecoder;
const response = await fetch;
const buffer = await response.arrayBuffer;
const decoded = decoder.decode);
const parser = new DOMParser;
const doc = parser.parseFromString;
console.log;

XML 内容含违法字符或未转义符号

XML 对字符集敏感， 比如控制字符、未闭合的 未转义的 & 等， 我始终觉得... 都会直接触发 not well-formed。

我好了。 真实正棘手的是那一些看似符合法规、 但因细微空格、换行、命名空间范围前缀不一致或 DTD 引用失效引起的解析失利——这时候别坚硬调，把原始 XML 复制进 https://www.example.com/validator 这类在线校验器，比手动查迅速得更多。

• 未闭合标签: 确保全部标签正确闭合， 如
• 未转义字符: 采用<, >, &, ', "转义特殊字符
• 违法控制字符: 移除或替换违法控制字符，如\x00-\x1F
• 命名空间范围问题: 检查命名空间范围声明和前缀有没有一致，避免拼写错误或较大较小写不一致

  
      content
  
          

• dtd引用失效情况的处理办法是删除dtd或者改成有效的dtd，总之很麻烦，反正我是被搞吐了。

怎样有效解决 not well-formed 错误？_v1.0.1

• 修正编码问题: 确保 XML 编码声明与实际传输编码一致， 采用 TextDecoder 处理不同编码
• 校验 XML 符合法规性: 采用在线工具或本地校验工具检查违法字符、未闭合标签等问题
• 处理特殊符号和命名空间范围: 转义&,, 确保命名空间范围前缀和声明一致
• 优化开发流程: 在开发阶段就严格校验 XML 服务端统一编码格式 建立完善的前端错误监控机制
最终还是只要你按照上述步骤一步步排查，一般都能解决not well-formed 的问题。希望本文对你有所协助。如果你还有其他疑问，请留言探讨。

---

本文一部分内容参考了网络上的开源资料，如有侵权，请联系作者删除。©2025 本文作者保留全部权益。

|