必须显式加 ON OVERFLOW 子句，否则19c仍报ORA-01489；LISTAGG默认返回VARCHAR2(4000)，超长即错；ON OVERFLOW有ERROR、TRUNCATE、TRUNCATE'…'、TRUNCATE''WITH COUNT四种行为；突破4000限制需用CAST AS CLOB或XMLAGG；NULL值致全组为NULL，须用NVL或WHERE过滤。
必须显式加 ON OVERFLOW 子句，否则 19c 也会报 ORA-01489 —— 不是版本高就自动兼容，漏写就崩。
为什么写了 LISTAGG 还报 ORA-01489？
因为 Oracle 默认把 LISTAGG 当作返回 VARCHAR2(4000) 的聚合函数，超长即中断。哪怕你用的是 19c，只要没写 ON OVERFLOW，就等同于 ON OVERFLOW ERROR，照样报错。
常见误判点：
- 以为“12cR2+ 支持
ON OVERFLOW” = “默认开启”，其实必须手写才生效 - 在子查询里裸写
LISTAGG(col, ',')，没WITHIN GROUP也不行，语法直接不通过 - 把
ORDER BY写在GROUP BY后面，而不是包在WITHIN GROUP ()里，排序无效还可能报ORA-30496
ON OVERFLOW 四种选项怎么选？
每种行为差异极大，选错等于丢数据或掩盖问题：
-
ON OVERFLOW ERROR：默认行为，报错终止 —— 适合强一致性校验场景 -
ON OVERFLOW TRUNCATE：静默截断，不提示、不加标记 —— 最危险，结果被砍了你也看不出 -
ON OVERFLOW TRUNCATE '…'：截断后加省略号，但分隔符和省略号本身占字节（如', …'占 3 字节） -
ON OVERFLOW TRUNCATE '' WITH COUNT：末尾补(5 more)类提示，推荐用于报表展示
完整写法示例：LISTAGG(name, ', ') WITHIN GROUP (ORDER BY id) ON OVERFLOW TRUNCATE '' WITH COUNT
真要完整拼接，别硬扛 LISTAGG
LISTAGG 再怎么加 ON OVERFLOW，返回值仍是 VARCHAR2，总长卡死在 4000 字节内。要突破限制，必须换类型或换函数：
- 用
CAST(... AS CLOB)包一层，但仅限目标字段能接CLOB；如果 INSERT 到VARCHAR2(4000)字段，照样报错 - 改用
XMLAGG：返回原生CLOB，无长度限制，典型写法：RTRIM(XMLCAST(XMLAGG(XMLELEMENT(e, name || ',') ORDER BY id) AS CLOB), ',') - 注意
XMLELEMENT会生成 XML 标签，必须套XMLCAST(... AS CLOB)+RTRIM剥离，不能只靠GETCLOBVAL()
NULL 值会让整个 LISTAGG 结果变 NULL
和 SUM 或 COUNT 不同，LISTAGG 遇到任意一个 NULL 输入，默认整组结果为 NULL，不是跳过。
- 用
NVL(name, '')或COALESCE(name, '')转空字符串（但会留下多余分隔符） - 用
WHERE name IS NOT NULL提前过滤，更干净 - 别信
ORDER BY NULL，Oracle 不保证顺序，要用就写ORDER BY 1或明确字段
真正容易被忽略的点：即使你用了 ON OVERFLOW TRUNCATE，只要目标列定义是 VARCHAR2(4000)，INSERT 或 UPDATE 时仍可能因隐式类型转换再次触发 ORA-01489 —— 截断发生在 SELECT 阶段，不等于存储阶段安全。
