XML良构性错误需逐项检查：标签严格配对闭合、特殊字符转义、编码声明与实际一致、根元素唯一且无前置空白或不可见字符。
XML格式不正确，本质是文档违反了“well-formed”（良构）规则。只要一个字符出错，解析器就会报错，且通常不提示具体原因。解决的关键不是猜，而是按标准逐项检查。
标签必须严格配对和闭合
XML不允许自闭合的开始标签（除非显式写成<tag></tag>），也不允许遗漏结束标签或错位嵌套。
- 错误写法：
<user><name>张三</name></user>（嵌套颠倒） - 正确写法：
<user><name>张三</name></user> - 空元素要明确闭合：
<photo></photo>或<photo></photo>，不能只写<photo></photo>
特殊字符必须转义
XML中 、<code>>、&、"、' 这5个字符在文本内容里不能直接出现，否则会被误认为是标记的一部分。
- 比如：
<desc>价格 </desc>→ 应改为<desc>价格 < 100元</desc> - 建议：所有用户输入内容在拼入XML前统一做转义（如用
xml.sax.saxutils.escape()或等效工具） - 注意：CDATA区可绕过转义，但仅适用于大段纯文本，且不能嵌套：
这里不用转义&符号]]>
编码声明与实际编码必须一致
文件开头的声明如 <?xml version="1.0" encoding="UTF-8"?> 不是摆设。如果声明是 UTF-8，但文件实际保存为 GBK，解析器读到乱码字节就会中断并报“格式错误”。
- 用编辑器（如 VS Code、Notepad++）确认文件真实编码，并与声明匹配
- 避免BOM干扰：UTF-8带BOM可能被某些解析器识别为非法字符，建议保存为“UTF-8 无BOM”
- 如果不确定编码，可先去掉声明，让解析器按默认（通常是UTF-8）尝试；成功后再补上对应声明
根元素唯一且存在
XML文档有且只能有一个顶层元素。常见陷阱包括：
- 多根节点：
<a>...</a><b>...</b>→ 必须包在一个父容器里，如<root><a>...</a><b>...</b></root> - 注释或空格出现在根元素之前：即使只有换行或空格，也可能导致解析器把它们当作文本节点，破坏“单根”结构
- 意外的不可见字符：比如复制粘贴时带入的零宽空格（U+200B）、字节顺序标记（BOM）等，可用十六进制编辑器排查
基本上就这些。XML的良构性是硬性语法要求，不依赖DTD或Schema。用支持XML高亮和校验的编辑器（如 VS Code + XML Tools 插件）能实时暴露问题，比手动排查快得多。
