XML常见报错与解决：错误信息逐条说明

XML（可扩展标记语言）是 W3C 于 1998 年发布的标记语言标准，用成对的标签描述数据结构，例如 <name>张三</name>。下面重点说明错误信息逐条说明。

XML常见报错与解决

• XML parsing error: not well-formed：标签未闭合或交错嵌套
• junk after document element：有多个根元素
• undefined entity：使用了 &nbsp; 等 HTML 实体，XML 只预定义了 5 个
• Invalid byte 1 of 1-byte UTF-8 sequence：文件实际编码与声明不一致

示例

输入：<book id="7"><title>诗经</title><price>29.8</price></book>

XML 转 JSON结果：

{
  "book": {
    "@id": "7",
    "title": "诗经",
    "price": "29.8"
  }
}

说明：属性加 @ 前缀，同名子元素合并为数组（常见约定）。

核心要点

• 必须有且只有一个根元素
• 标签区分大小写，必须正确闭合和嵌套
• 属性值必须加引号
• 特殊字符 < & 要写成 &lt; &amp;
• 开头可以有声明 <?xml version="1.0" encoding="UTF-8"?>

规则说明

• 元素名不能以数字或“xml”开头
• 空元素可以写成 <br/>
• 注释写法 <!-- ... -->，不能嵌套
• CDATA 段 <![CDATA[ ... ]]> 中的内容不解析
• “格式良好”是语法正确，“有效”是还符合 DTD/XSD

本站的XML/JSON互转工具可以直接处理，计算在浏览器本地完成，适合快速核对结果。

常见问题

【什么是 XXE？】XML 外部实体注入，攻击者通过 DOCTYPE 引用本地文件或内网地址，解析时应禁用外部实体。

【XML 能写注释吗？】可以，用 <!-- 注释 -->。

【XML 和 HTML 有什么区别？】HTML 用于展示网页，标签固定、语法宽松；XML 用于描述数据，标签自定义、语法严格。

文中示例可以在本站对应工具中验证；处理密码、证件号等敏感数据时，请注意保护隐私。

标签： 文本处理