ora-01489错误源于listagg结果超varchar2长度限制（sql引擎中为4000字节），解决需先确认oracle版本是否≥12cr2以支持on overflow子句，否则应改用xmlagg转clob或自定义聚合函数。
ORA-01489错误出现时，先确认Oracle版本和溢出处理选项是否可用
Oracle 19c 支持 ON OVERFLOW 子句，但该功能实际从 12cR2 就已引入，不是 19c 独有。如果查询报 ORA-01489: 字符串连接的结果太长，首先要查版本并验证语法支持：
-
SELECT banner FROM v$version;—— 确认是 12cR2 或更高（含 19c） - 若版本达标但仍报错，大概率是用了旧写法（比如漏掉
ON OVERFLOW或拼写错误） -
ON OVERFLOW TRUNCATE是默认行为，但必须显式写出才能生效；不写就等同于无该子句，仍会报错
用 ON OVERFLOW TRUNCATE + WITHIN GROUP 避免报错
这是最轻量、最接近原 LISTAGG 语义的修复方式，适用于允许截断的报表或展示场景。
- 语法必须完整：
LISTAGG(col, ',') WITHIN GROUP (ORDER BY col) ON OVERFLOW TRUNCATE - 可选加后缀：如
ON OVERFLOW TRUNCATE '...' WITH COUNT，会在末尾补省略号并附计数（如... (3 more)） - 注意：
TRUNCATE后字符串总长仍受VARCHAR2(4000)限制，不是无限长 —— 它只是把超长部分砍掉，不抛异常 - 不要和
SUBSTR(..., 1, 3999)嵌套使用，那会多一层计算且可能截断不干净
需要完整保留内容？改用 XMLAGG + CLOB
当业务要求“一个字都不能丢”（比如日志合并、审计摘要），ON OVERFLOW 不够用，必须绕过 VARCHAR2 限制，走 CLOB 路线。
- 核心组合是：
XMLAGG(XMLELEMENT(...))→.EXTRACT('//text()').GETCLOBVAL() - 示例：
RTRIM(XMLAGG(XMLELEMENT(e, description || '; ').EXTRACT('//text()').GETCLOBVAL(), '; ') - 注意
XMLELEMENT会自动转义特殊字符（如&变成&），若原始数据含 HTML/XML 符号，需额外REPLACE处理 - 性能比原生
LISTAGG低 20%–40%，大数据量分组下要测执行计划
容易被忽略的字符集陷阱
很多人试了 ON OVERFLOW 还报错，或发现明明只拼了 1000 个汉字就溢出 —— 很可能是 UTF-8 字节膨胀没算准。
- Oracle 中
VARCHAR2限制按「字节」算，不是「字符」；UTF-8 下一个中文占 3 字节，一个 emoji 占 4 字节 - 用
DUMP(description, 1016)查单个字段实际字节数，别只看LENGTH(description) - 聚合前建议加长度预估：
SUM(LENGTHB(description)) + (COUNT(*) - 1) * LENGTHB(',')，超过 4000 就得走XMLAGG - 如果表定义用的是
AL32UTF8字符集，且字段含大量中文，4000 字节 ≈ 1333 个汉字左右，远低于直觉
