必须用XMLAGG替代LISTAGG，因其返回CLOB类型突破4000字节限制，避免ORA-01489报错；LISTAGG强制VARCHAR2(4000)，超长即失败，而XMLAGG+XMLELEMENT+XMLCAST可安全拼接超长文本。
直接用 XMLAGG + XMLELEMENT + XMLCAST，绕过 LISTAGG 的 4000 字节硬限制，这是 Oracle 11g 起最稳的超长文本聚合方案。
为什么必须用 XMLAGG 替代 LISTAGG？
Oracle 对 LISTAGG 返回值强制限定为 VARCHAR2(4000)，超长直接报 ORA-01489，不是警告，是查询失败。哪怕你加了 ON OVERFLOW TRUNCATE（12.2+ 才支持），也只是静默丢数据，且无法控制保留哪些项。而 XMLAGG 配合 XMLCAST(... AS CLOB) 可返回真正无长度上限的 CLOB，适合日志、描述、长备注等场景。
-
LISTAGG是“字符串拼接函数”，本质受限于字符类型宽度 -
XMLAGG是“XML 节点聚合函数”，输出可转为CLOB，天然支持大对象 - 11g 就能用，不依赖高版本特性；比写 PL/SQL 自定义函数轻量得多
XMLAGG 基础写法与常见错误
核心结构是：XMLAGG(XMLELEMENT(...)) → XMLCAST(... AS CLOB) → RTRIM 去尾部分隔符。漏掉任意一环都可能出错或返回 XML 标签残留。
- 必须用
XMLELEMENT(e, expr)包裹字段，e是任意合法标签名，不能省略 -
XMLAGG后必须跟ORDER BY，否则结果顺序不确定（不像LISTAGG报错，它只是不保证） - 直接
XMLAGG(...).GETCLOBVAL()在某些版本会报错，推荐统一用XMLCAST(... AS CLOB) - 别用
EXTRACT('//text()')，它在含特殊字符（如&、）时易出错；<code>XMLCAST更安全
正确示例：
SELECT deptno,
RTRIM(XMLCAST(XMLAGG(XMLELEMENT(e, ename || ', ') ORDER BY empno) AS CLOB), ', ') AS emp_list
FROM scott.emp
GROUP BY deptno;
处理 NULL 和特殊字符的实操要点
XMLAGG 默认保留 NULL，但会生成空节点（<e/>），导致拼接串里多出多余分隔符。这不是 bug，是行为差异——LISTAGG 默认跳过 NULL，XMLAGG 不跳。
- 想跳过
NULL：在外层用WHERE column_name IS NOT NULL过滤，或用NVL(column_name, '')转为空字符串 - 想显式标出
[空]：用NVL(column_name, '[空]')，确保类型一致（避免隐式转VARCHAR2截断） - 字段含
&、、<code>>等：XMLELEMENT会自动转义，无需额外处理；但若后续要解析成纯文本，XMLCAST已足够 - 分隔符不能是 XML 控制字符，逗号、竖线、空格都安全；避免用
<或&本身作分隔符
性能与兼容性注意事项
XMLAGG 比 LISTAGG 多一层 XML 构建和转换开销，大数据量（单组 >1000 行）时延迟明显，但仍是纯 SQL 中最可控的方案。
- Oracle 10g 起可用，11g+ 稳定；低于 10g 需用
SYS_CONNECT_BY_PATH（复杂且易报ORA-1489） - 不要在
XMLAGG内部对CLOB字段直接拼接，先用TO_CHAR或SUBSTR截断到合理长度（如SUBSTR(text_col, 1, 4000)） - 如果最终要导出或传给应用层，确认接收方能处理
CLOB类型；否则加TO_CHAR转换，但需承担截断风险 - 排序字段建议选索引列（如主键、时间戳），避免
XMLAGG(... ORDER BY function(col))引发全表扫描
真正难的不是写出能跑的语句，而是意识到：一旦业务要求“不能丢数据”，LISTAGG 就不再是默认选项，而 XMLAGG 的 XML 转换细节——比如是否用 XMLCAST 而非 GETCLOBVAL，是否过滤 NULL——必须每处都显式声明，没法靠“默认行为”蒙混过关。
