XPath中提供了parse-xml()和parse-xml-fragment()两个用于解析XML字符串的函数，两者虽然都能将字符串转换为XML节点，但在设计目标和适用场景上存在明显区别。理解这些差异可以帮助开发者更精准地选择合适的函数处理不同的XML内容。
核心差异对比
两个函数的基础差异可以通过下表快速了解：
| 对比维度 | parse-xml() | parse-xml-fragment() |
|---|---|---|
| 输入要求 | 必须是完整的格式良好的XML文档，包含根元素 | 可以是XML片段，不需要完整的文档结构 |
| 返回值结构 | 返回文档节点，包含完整的XML文档结构 | 返回文档片段节点，仅包含输入的片段内容 |
| 根元素要求 | 必须有且仅有一个根元素 | 可以有零个或多个根级元素/文本节点 |
| 命名空间处理 | 支持完整的XML命名空间声明 | 片段中的命名空间需要依赖上下文或显式声明 |
功能细节说明
parse-xml()的使用限制
parse-xml()函数的输入必须是一个完整的XML文档，也就是必须有一个唯一的根元素，不能存在多个并列的顶级元素，也不能只有文本内容没有包裹元素。如果输入不符合要求，函数会返回错误。
示例代码如下：
(: 正确的输入，完整的XML文档 :) let $xml-doc := <root><item id="1"/><item id="2"/></root> let $parsed := parse-xml($xml-doc) return $parsed/root/item/@id (: 错误输入，多个顶级元素，会报错 :) let $wrong-xml := <item/><item/> let $parsed-wrong := parse-xml($wrong-xml) return $parsed-wrong
parse-xml-fragment()的灵活特性
parse-xml-fragment()函数对输入的要求更宽松，它可以处理不完整的XML片段，比如多个并列的元素、单独的文本节点、甚至是没有闭合的标签（只要片段本身语法合理）。返回的结果是文档片段节点，不会强制要求根元素存在。
示例代码如下：
(: 处理多个并列元素的片段 :) let $fragment := <item id="1"/><item id="2"/> let $parsed-fragment := parse-xml-fragment($fragment) return $parsed-fragment/item/@id (: 处理纯文本片段 :) let $text-fragment := "这是一段XML片段文本" let $parsed-text := parse-xml-fragment($text-fragment) return $parsed-text
适用场景区分
在实际开发中，可以根据输入内容的结构选择对应的函数：
- 如果处理的字符串是完整的XML文档，比如从文件读取的XML内容、接口返回的完整XML响应，优先使用
parse-xml()函数，能获得更规范的文档结构。 - 如果处理的是XML片段，比如从大文档中提取的部分内容、拼接的不完整XML结构、用户输入的零散XML标签，使用
parse-xml-fragment()函数更合适，避免因为结构不完整导致解析失败。
注意事项
两个函数都要求输入的字符串是符合XML基本语法的，比如标签必须正确闭合、属性值必须用引号包裹，否则都会返回解析错误。另外，不同XPath实现（比如XQuery、XSLT中的XPath）对这两个函数的支持可能存在细微差异，使用前需要确认运行环境是否支持对应的函数版本。
需要注意的是，parse-xml-fragment()函数解析的片段如果包含命名空间前缀，需要确保前缀在片段内有对应的命名空间声明，否则可能出现命名空间无法识别的问题。
XPathparse_xml_fragmentparse_xmlXML解析函数区别修改时间：2026-07-16 22:39:28