XMLQUERY要求输入为XMLTYPE，CLOB需显式转换；带命名空间的XML必须在查询中声明；RETURNING CONTENT返回XML片段，RETURNING SEQUENCE返回原子值；多字段提取应使用XMLTABLE而非多个XMLQUERY。
XMLQUERY 要求 XML 类型输入，别直接传字符串
Oracle 和 DB2 支持 XMLQUERY，但它不接受普通 VARCHAR2 或 CLOB 字符串——必须先转成 XMLTYPE。常见错误是直接写 XMLQUERY('/root/item' PASSING my_xml_col)，而 my_xml_col 是 CLOB，会报 ORA-19172: XQuery syntax error 或更隐蔽的类型不匹配。
正确做法是显式转换：
XMLQUERY('/root/item/name' PASSING XMLTYPE(my_xml_col) RETURNING CONTENT)
如果源字段已是 XMLTYPE（比如定义为 XMLTYPE 列），可省略转换；但生产环境里多数 XML 存在 CLOB 中，这步不能跳。
路径表达式里 namespace 必须显式声明
带命名空间的 XML（如 <rss xmlns="http://purl.org/rss/1.0/">）用 XMLQUERY 时，路径里不加 namespace 前缀，结果永远为空。这不是语法错，是静默失败。
必须用 xmlns 在 XMLQUERY 中声明，并在路径中使用前缀：
XMLQUERY('declare default element namespace "http://purl.org/rss/1.0/"; /rss/channel/item/title' PASSING XMLTYPE(xml_data) RETURNING CONTENT)
或者用带前缀的方式（更可控）：
XMLQUERY('declare namespace rss="http://purl.org/rss/1.0/"; /rss:rss/rss:channel/rss:item/rss:title' PASSING XMLTYPE(xml_data) RETURNING CONTENT)
注意：declare default element namespace 只影响元素名，不影响属性；属性仍需加前缀或用 @* 匹配。
RETURNING CONTENT vs RETURNING SEQUENCE 的行为差异
RETURNING CONTENT 返回一个 XML 片段（如 <name>Alice</name>），适合嵌套提取或进一步解析；RETURNING SEQUENCE（Oracle 12c+）返回原子值序列（如纯文本 Alice），但只适用于单层、无嵌套的节点。
容易踩的坑：
- 想取文本却用了
RETURNING CONTENT，结果带标签，后续TO_CHAR()可能报ORA-19279: XPTY0004 - 用了
RETURNING SEQUENCE却传入含子节点的路径（如/item），返回空——它只认叶子文本节点 - 多值场景下（如多个
<tag>），RETURNING CONTENT默认只返回第一个，要全量得配合XMLTABLE
简单取文本推荐：
XMLCAST(XMLQUERY('/root/item/name/text()' PASSING XMLTYPE(xml_col) RETURNING CONTENT) AS VARCHAR2(100))
嵌套结构建议改用 XMLTABLE，别硬扛 XMLQUERY
XMLQUERY 擅长单点提取，一旦要同时取 id、name、price 并按行对齐，写一堆独立 XMLQUERY 表达式不仅慢，还会因节点缺失导致行错位（比如第 3 个 name 对应第 5 个 price）。
真正可靠的解法是用 XMLTABLE 配合 XMLQUERY 做二次解析：
SELECT x.id, x.name, x.price
FROM xml_data_table t,
XMLTABLE('/root/items/item'
PASSING XMLTYPE(t.xml_content)
COLUMNS
id NUMBER PATH 'id',
name VARCHAR2(50) PATH 'name',
price NUMBER PATH 'price'
) x
这是 Oracle 官方推荐模式。XMLQUERY 留给“从已知结构里抠一个字段”这种轻量任务就够了。
复杂 XML 的 namespace、默认命名空间、混合内容、空节点处理，全堆在单个 XMLQUERY 里只会让逻辑不可维护。该切就切，别撑着。
