ora-01489是varchar2字节上限导致的硬性限制，非配置问题；listagg必须用within group(order by)语法；on overflow truncate仅12cr2+支持且会丢数据；xmlagg+xmlelement+getclobval组合可返回clob彻底规避限制。
ORA-01489 错误是硬性字节限制，不是配置或语法问题
Oracle 的 LISTAGG 函数返回类型固定为 VARCHAR2，而该类型在 AL32UTF8 字符集下最大只能容纳 4000 字节——注意是「字节」，不是「字符」。中文、emoji 或某些扩展字符占 2~4 字节，很容易在几十个字段拼接后就超限。这不是你写错了 ORDER BY，也不是数据库参数没调好，而是函数设计层面的刚性约束。
LISTAGG 必须写 WITHIN GROUP (ORDER BY)，否则直接报 ORA-30496
很多人以为加个 ORDER BY 在外面就能控制顺序，结果一执行就报错：
-
SELECT LISTAGG(name, ',') FROM t ORDER BY name;→ ❌ 报ORA-30496 - 正确写法必须把排序逻辑塞进聚合子句：
LISTAGG(name, ',') WITHIN GROUP (ORDER BY name) - 即使你只想要“任意稳定顺序”，也得显式写
WITHIN GROUP (ORDER BY rowid)或WITHIN GROUP (ORDER BY 1)，否则语法不通过
ON OVERFLOW TRUNCATE 只在 Oracle 12cR2+ 有效，且不能解决完整数据需求
12cR2 起支持截断策略，但默认仍是 ON OVERFLOW ERROR（即报 ORA-01489）：
- 显式截断写法：
LISTAGG(col, ',') WITHIN GROUP (ORDER BY col) ON OVERFLOW TRUNCATE '...' - 它会在超限时自动砍掉末尾、补上你指定的后缀，但原始数据已丢失
- 想保留全部内容？
TO_CLOB(LISTAGG(...))是无效的——LISTAGG内部先按 VARCHAR2 拼，超限早就在函数执行阶段报错了，根本走不到TO_CLOB这一步
真正能绕过 4000 字节限制的只有 XMLAGG + CLOB 组合
这是目前最通用、兼容性最强的替代方案（从 Oracle 9i 到 23c 都可用）：
- 核心写法：
RTRIM(XMLAGG(XMLELEMENT(e, col || ',') ORDER BY col).GETCLOBVAL(), ',') - 它返回的是
CLOB类型，理论长度上限是 4GB，彻底避开 VARCHAR2 限制 - 注意：必须在
XMLAGG内写ORDER BY，外部排序无效；XMLELEMENT会把特殊字符（如&、）转义成 XML 实体，若源数据含 HTML 或 XML 片段，需额外处理 - 性能比
LISTAGG低 2~5 倍，大数据量时要实测，别盲目替换
最容易被忽略的一点：空分组时 LISTAGG 返回 NULL，不是空字符串；而 XMLAGG 在无数据时返回空 CLOB，两者行为不一致。如果后续用 CONCAT 或拼接前缀，必须统一用 NVL 或 COALESCE 处理，否则逻辑断裂。
