listagg必须显式写within group(order by...)，否则报ora-30488；默认返回varchar2(4000)，超长抛ora-01489；去重需子查询，distinct语法非法。
必须显式写 WITHIN GROUP (ORDER BY ...)，否则直接报 ORA-30488；默认返回 VARCHAR2(4000)，超长就炸出 ORA-01489；去重得靠子查询，LISTAGG(DISTINCT ...) 是非法语法。
LISTAGG 报 ORA-30488：缺 ORDER BY 子句
Oracle 19c 起强制要求 WITHIN GROUP 内必须带 ORDER BY，哪怕你不在乎顺序也不能省略。老脚本从 11g 迁移过来常在这卡住。
-
LISTAGG(ename, ', ')→ 错误：缺少WITHIN GROUP -
LISTAGG(ename, ', ') WITHIN GROUP ()→ 错误：ORA-30488 - 正确写法：
LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) - 排序字段含
NULL时，默认排最前；要挪到末尾加NULLS LAST，例如ORDER BY ename NULLS LAST
拼接结果超长：ORA-01489 怎么办
LISTAGG 默认返回 VARCHAR2(4000)，只要拼出来总长度 > 4000 字节，立刻抛 ORA-01489。12.2+ 支持 ON OVERFLOW，19c 完全可用，但旧脚本几乎都不加。
- 安全截断（报表场景推荐）：
LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) ON OVERFLOW TRUNCATE '...' WITHOUT COUNT - 带截断计数提示：
ON OVERFLOW TRUNCATE '...' WITH COUNT→ 结尾自动加(12)表示丢了 12 字符 - 要稳定返回
CLOB（后续还要处理）：外层套TO_CLOB(LISTAGG(...))，注意ON OVERFLOW本身不改变返回类型
想拼接前去重：不能用 DISTINCT 参数
LISTAGG 语法根本不接受 DISTINCT 关键字，写 LISTAGG(DISTINCT ename, ', ') 会报 ORA-30494 或解析失败。
- 唯一稳妥方式是子查询提前去重：
SELECT deptno, LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) FROM (SELECT DISTINCT deptno, ename FROM emp) GROUP BY deptno - 如果去重要按业务逻辑（比如取最新一条、按优先级选），必须把逻辑写进子查询或 CTE，别指望
LISTAGG自己搞定 - 用
ROW_NUMBER()+PARTITION BY也能实现复杂去重，但 SQL 更长、可读性差，容易漏WHERE rn = 1
真正麻烦的不是语法本身，而是那些藏在迁移脚本里的隐性假设：比如默认排序行为、隐式长度限制、还有开发时没压测大数据量导致上线后某天突然 ORA-01489。别只盯着函数怎么写，得看它跑在哪张表、数据量级、以及下游是否真能消化 CLOB 或截断字符串。
