XQuery中使用if-then-else后XML声明丢失的原因及解决方法

问题原因 #

XQuery处理器是否输出XML声明，核心看返回结果的类型：

• 代码1和代码2直接返回单一文档节点时，处理器会默认在序列化阶段添加XML声明；
• 而if-then-else表达式的返回值是节点序列——哪怕两个分支各自返回的都是文档节点，整个表达式的结果是「二选一的节点序列」，而非单一的文档节点。处理器对序列不会自动触发XML声明的输出，所以最终结果里就没了<?xml version="1.0"?>。

解决办法 #

有两种靠谱的处理方式：

1. 显式包裹为单一文档节点 #

用document{}把if-then-else的结果整个包起来，强制让处理器识别为一个完整的文档节点，序列化时就会自动添加XML声明：

document {
  if (string-length($target-node) > 10) then
    (: 代码1的节点插入逻辑，返回元素/节点集 :)
    <root>
      <item>插入内容1</item>
    </root>
  else
    (: 代码2的节点插入逻辑 :)
    <root>
      <item>插入内容2</item>
    </root>
}

2. 强制指定序列化参数（依赖处理器） #

如果使用的XQuery处理器支持（比如Saxon、BaseX），可以在执行时显式设置序列化参数，强制输出XML声明，不管返回的是节点还是序列。比如Saxon中可以加参数：

java -jar saxon-he.jar -s:input.xml -q:query.xq !omit-xml-declaration=no

这种方式不需要修改XQuery代码，但要注意不同处理器的参数语法可能有差异。

内容的提问来源于stack exchange，提问作者Rico Strydom