LISTAGG默认返回VARCHAR2(4000)，超4000字节即报ORA-01489错误；Oracle 12.2+可用ON OVERFLOW ERROR WITH COUNT RETURNING CLOB解决，低版本则须改用XMLAGG+XMLELEMENT组合返回CLOB。
LISTAGG 默认返回 VARCHAR2，超长会报 ORA-01489 错误
Oracle 12c 及以前版本中，LISTAGG 默认返回 VARCHAR2(4000)，一旦拼接结果超过 4000 字节（注意是字节，非字符），就会直接抛出 ORA-01489: result of string concatenation is too long。这不是数据问题，而是类型限制——哪怕你只拼 3 个中文字段，每个占 3 字节，加起来超了也照样失败。
常见误操作是加 ON OVERFLOW TRUNCATE，但它只是截断并加省略标记，不解决根本问题；更糟的是，它默认不报错，容易掩盖数据丢失。
- 必须显式指定返回类型为
CLOB，且 Oracle 版本需 ≥ 12.2（12.1 不支持ON OVERFLOW+CLOB） -
ON OVERFLOW TRUNCATE不能和CLOB同时用：Oracle 不允许对CLOB做截断，否则报ORA-30496 - 若用
CAST(... AS CLOB)包裹整个LISTAGG表达式，无效——Oracle 仍按内部规则先算成VARCHAR2再转，超限早于转换发生
正确写法：用 ON OVERFLOW ERROR WITH COUNT 检测 + CLOB 显式声明
Oracle 12.2+ 支持在 LISTAGG 中用 ON OVERFLOW ERROR WITH COUNT 主动暴露长度，并配合 RETURNING CLOB 强制输出类型。这是目前唯一能稳定处理超长拼接的原生方案。
SELECT
deptno,
LISTAGG(ename, ', ')
WITHIN GROUP (ORDER BY empno)
ON OVERFLOW ERROR WITH COUNT
RETURNING CLOB AS enames_clob
FROM scott.emp
GROUP BY deptno;
注意：WITH COUNT 会在错误信息里附带当前已拼长度（字节），方便定位哪组超限；RETURNING CLOB 必须紧跟在 ON OVERFLOW 子句后，顺序不能错。
- 如果业务允许容忍部分组失败，就保留
ON OVERFLOW ERROR，让应用层捕获异常再降级处理 - 若必须全部成功，得放弃
LISTAGG，改用分页拼接或 PL/SQL 自定义聚合函数（如用DBMS_LOB累积） - 别信网上“
TO_CLOB(LISTAGG(...))”写法——它本质还是先拼VARCHAR2，超限时已报错，转CLOB根本执行不到
替代方案：用 XMLAGG + EXTRACT 处理任意长度（兼容 9i+）
当环境卡在 12.1 或更低版本，或者需要跨版本兼容，XMLAGG 是最稳妥的备选。它天然返回 CLOB，无 4000 字节硬限制，且语法稳定。
SELECT
deptno,
RTRIM(
EXTRACT(
XMLAGG(XMLELEMENT(E, ename || ', ') ORDER BY empno),
'/E/text()'
).GETCLOBVAL(),
', '
) AS enames_clob
FROM scott.emp
GROUP BY deptno;
关键点在于：XMLELEMENT 构造 XML 片段，XMLAGG 聚合，EXTRACT(...).GETCLOBVAL() 提取为 CLOB，最后用 RTRIM 去掉末尾逗号。性能比 LISTAGG 略低，但胜在可靠。
- 分隔符要写进
XMLELEMENT内容里（如ename || ', '），不能靠外部拼接，否则空值会导致多余分隔符 -
EXTRACT返回XMLTYPE，必须调用.GETCLOBVAL()才能得到真正CLOB，否则仍是 XML 包装对象 - 如果源字段含特殊字符（、&），
XMLELEMENT会自动转义，无需额外处理
实际使用中最容易被忽略的细节
很多人调通了语句就以为万事大吉，但生产环境常因这几个点翻车：
-
LISTAGG的ORDER BY子句不可省略——Oracle 12.1+ 要求必须指定排序依据，否则报ORA-30497 - 字符集影响字节计算：AL32UTF8 下一个中文占 3 字节，拼 1334 个中文就超 4000；而 ZHS16GBK 下占 2 字节，能拼到 2000 个左右——得按实际数据库字符集估算容量
- 用
XMLAGG时，如果ename为NULL，XMLELEMENT会生成空节点，导致结果多出冗余逗号，需提前NVL(ename, '')过滤
