XMLTABLE解析带命名空间XML返回空结果，根本原因是XPath默认不识别默认命名空间（xmlns="..."），必须通过XMLNAMESPACES显式绑定前缀并在PATH中严格使用；未声明则匹配失败，静默返回空行。
XMLTABLE 解析带命名空间的 XML 时为什么返回空结果
直接用 xmltable 查询含命名空间（如 xmlns="http://example.com/ns"）的 xml，几乎必然返回空行——因为默认命名空间不被识别为“无前缀”，而 xmltable 的 xpath 表达式必须显式声明并使用前缀才能匹配。
根本原因：XPath 规范中，未加前缀的元素名只匹配无命名空间的节点；即使 XML 中写了 xmlns="..."，它定义的是默认命名空间，不是“无命名空间”。
- 错误写法：
XMLTABLE('/root/item' PASSING xml_doc COLUMNS name VARCHAR2(50) PATH 'name')→ 匹配不到任何item - 正确前提：必须在
XMLNAMESPACES子句中为默认命名空间绑定前缀（哪怕只是临时用ns），并在 XPath 中使用该前缀 - 注意：
XMLNAMESPACES必须紧跟在XMLTABLE关键字后、PASSING前，顺序错就报错
XMLNAMESPACES 子句怎么写才生效
XMLNAMESPACES 不是可选装饰，而是解析默认命名空间的强制入口。它的写法有明确约束：
- 若 XML 有默认命名空间（
xmlns="http://abc.com"），必须用DEFAULT 'http://abc.com'或'http://abc.com' AS "ns"绑定前缀 - 若 XML 同时含多个命名空间（如
xmlns:ns1="http://a.com" xmlns:ns2="http://b.com"），需全部列出：XMLNAMESPACES('http://a.com' AS "ns1", 'http://b.com' AS "ns2") - 不能省略引号：
'http://example.com'是字符串字面量，漏单引号会报ORA-31011: XML parsing failed - 前缀名可以任意（
"x"、"d"都行），但 XPath 中必须严格一致，大小写敏感
示例（实际可用）：
SELECT x.name, x.price
FROM xml_tab t,
XMLTABLE(
XMLNAMESPACES(DEFAULT 'http://example.com/ns'),
'/root/item'
PASSING t.xml_col
COLUMNS
name VARCHAR2(50) PATH 'name',
price NUMBER PATH 'price'
) x;
PATH 表达式里 namespace 前缀要不要加
要加——但只加在元素名前，且必须与 XMLNAMESPACES 中定义的前缀一致。这是最容易漏掉的一环。
- 如果用了
DEFAULT 'http://example.com/ns'，XPath 中仍要写成'ns:name'？不对。此时DEFAULT表示“把该 URI 当作默认命名空间”，路径中元素名**仍不加前缀**（即保持'name'）——这是 Oracle 的特殊行为，和标准 XPath 不同 - 如果用了
'http://example.com/ns' AS "ns"，则路径中所有属于该命名空间的元素都必须加ns:，例如'ns:name'、'ns:price' - 混合命名空间时，不同前缀必须区分清楚：
'ns1:title'和'ns2:author'不能混用 - 属性访问同理：
@ns:id，不能写成@id（除非该属性本身无命名空间）
遇到 ORA-19279 XQST0025 错误怎么办
这个错误信息是“XQuery sequence has more than one item, expected only one”，表面看是 XPath 返回多节点，实则 80% 情况是命名空间没对上，导致 XMLTABLE 在错误上下文中执行 XPath，意外匹配到多个无关节点（比如整个文档根或注释）。
- 先确认 XML 是否真有默认命名空间：用
SELECT EXTRACT(xml_col, '/').getStringVal() FROM xml_tab看原始结构 - 检查
XMLNAMESPACES中的 URI 字符串是否与 XML 中完全一致（包括末尾斜杠、大小写） - 临时去掉所有命名空间声明再试一次：如果这时能查出数据，基本锁定是命名空间配置问题
- 避免用
//item这种模糊路径——它可能跨层级匹配多个，优先用绝对路径如/root/item
复杂点在于：Oracle 对默认命名空间的处理逻辑和主流 XPath 引擎不一致，而且错误提示不指向根源。一旦 XML 结构稍深、命名空间嵌套，就必须逐层验证每个 PATH 表达式的上下文是否真的落在目标命名空间内。
