用 for + where 模拟 inner join 最常用也最可控：通过嵌套 for 遍历两文档节点，用 where 实现等值连接，适合小到中等规模数据，但笛卡尔积导致性能随数据量增大而下降。
用 for + where 模拟 inner join 最常用也最可控
XML 本身没有“表”概念，XQuery 也不提供 SQL 风格的 JOIN 关键字，但可以用嵌套 for 表达式配合 where 条件实现等值连接。这是跨文档关联最直接的方式，尤其适合小到中等规模数据。
假设你有两个 XML 文档：orders.xml（含 <order id="101"></order>）和 customers.xml（含 <customer custid="101"></customer>），想按订单 ID 关联客户姓名：
for $o in doc("orders.xml")//order
for $c in doc("customers.xml")//customer
where $o/@id = $c/@custid
return <joined>
<order-id>{$o/@id}</order-id>
<customer-name>{$c/name/text()}</customer-name>
</joined>
- 必须用
doc()显式加载第二个文档；不写路径默认是当前上下文文档 -
@id和@custid要确保类型一致——如果一个是字符串、一个是数字，比较可能静默失败；建议统一用string()包裹 - 这种写法本质是笛卡尔积后过滤，性能随文档增大明显下降；上万节点时需谨慎
用 key() 加速查找，适合大文档+高频匹配
当一个文档（如 customers.xml）被多次引用，且连接字段有唯一性（如 @custid 是主键），可用 key() 预建索引提升效率。这比双重 for 快得多，且语义更清晰。
先在 XQuery 中声明 key（注意：部分处理器如 BaseX 支持，但 Saxon 原生不支持文档级 key 声明，需改用 map:map 或函数封装）：
declare key customer-key using @custid on doc("customers.xml")//customer;
for $o in doc("orders.xml")//order
let $c := key("customer-key", $o/@id, doc("customers.xml"))
where exists($c)
return <joined>
<order-id>{$o/@id}</order-id>
<customer-name>{$c/name/text()}</customer-name>
</joined>
-
key()第三个参数必须显式传入目标文档，不能省略 - 不是所有 XQuery 引擎都支持外部文档的
key声明（比如浏览器内建 XPath 不支持），生产前务必验证运行环境 - 若
@custid不唯一，key()会返回多个节点，需用$c[1]或聚合处理
用 fn:inner-join()（XQuery 3.1+）但兼容性差
XQuery 3.1 引入了 fn:inner-join()、fn:left-join() 等高阶函数，语法接近 SQL，但实际落地受限严重：
inner-join(
doc("orders.xml")//order,
doc("customers.xml")//customer,
function($o) { $o/@id },
function($c) { $c/@custid },
function($o, $c) { <joined><order-id>{$o/@id}</order-id><name>{$c/name/text()}</name></joined> }
)
- 仅 Saxon-PE/EE 10+、BaseX 10+ 等较新版本支持；eXist-db 5.x 尚未完整实现
- 函数参数里必须用匿名函数提取连接键，不能直接写
$o/@id—— 写错会报XPDY0002类型错误 - 左连接或全连接需求时，
fn:left-join()的空匹配结果是空序列，需额外判断是否为()
跨文档连接失败的三个典型信号
连接没结果？先盯住这三个地方：
- 路径错误：写成
doc("customer.xml")但文件名是customers.xml，错误信息常是FODC0002（文档未找到） - 命名空间干扰：若 XML 带
xmlns="http://example.com"，//customer会匹配失败，必须用//x:customer并声明declare namespace x = "http://example.com" - 空白或换行影响：某些文档中
@id实际值是" 101 "（带空格），用normalize-space($o/@id)再比较
真正麻烦的不是语法，而是 XML 数据本身的质量——ID 字段是否真的一致、有没有隐藏字符、命名空间是否对齐。这些细节不验清楚，再漂亮的 XQuery 也连不出结果。
