LISTAGG必须配合GROUP BY和WITHIN GROUP(ORDER BY)使用，漏写或错放ORDER BY会报ORA-30497/ORA-30488；遇NULL值整行结果变NULL；超长默认报ORA-01489，12.2+支持ON OVERFLOW TRUNCATE或RETURNING CLOB。
LISTAGG 必须写在 GROUP BY 查询里，且 WITHIN GROUP (ORDER BY ...) 不能省、不能外移，否则直接报错。
为什么一用就 ORA-30497 或 ORA-30488？
这两个错误本质是同一类：没写或写错 ORDER BY 子句。LISTAGG 在 11gR2 起强制要求排序依据，哪怕你只想要“稳定顺序”，也得显式指定字段（比如主键、时间戳或 ROWID）。
-
LISTAGG(name, ',')单独出现 → 报ORA-30497 -
SELECT ... LISTAGG(...) FROM t ORDER BY name→ 报ORA-30488（ORDER BY放错位置） - 正确写法只有：
LISTAGG(name, ', ') WITHIN GROUP (ORDER BY id) -
ORDER BY里支持表达式（如UPPER(name)），但不支持子查询、窗口函数或CASE嵌套太深的逻辑
NULL 值会让整行结果变 NULL，不是跳过
和 COUNT 不同，LISTAGG 遇到任意一个输入值为 NULL，整个分组结果就是 NULL——这是“污染”行为，极易被忽略。
- 用
NVL(col, '')或COALESCE(col, '')把NULL转成空字符串最稳妥 - 如果后续拼接会多出多余分隔符（如
a,,b），再套一层TRIM(both ',' from ...)或正则REGEXP_REPLACE(..., ',+', ',') - 用
WHERE col IS NOT NULL提前过滤更干净，但要确认业务是否允许丢数据 - LEFT JOIN 后右表无匹配行时，
LISTAGG返回NULL（不是''），建议外层包NVL(LISTAGG(...), '')
超长就炸：ORA-01489 怎么绕过去？
LISTAGG 默认返回 VARCHAR2(4000)，超出即报 ORA-01489。这个限制在函数执行阶段硬编码，改列类型、加 CAST、甚至目标字段定义为 CLOB 都无效。
- Oracle 12.2+ 推荐显式启用截断：
LISTAGG(col, ', ') WITHIN GROUP (ORDER BY id) ON OVERFLOW TRUNCATE '' WITH COUNT -
WITH COUNT会在末尾追加类似(12 more)的提示；WITHOUT COUNT就纯截断 - 要完整结果，必须换
XMLAGG(XMLELEMENT(e, col || ','))+EXTRACT(...).GETCLOBVAL()，返回CLOB，但性能略低、结果含 XML 标签需剥离 - 别指望
OVER (PARTITION BY ...)——LISTAGG本身不支持直接作分析函数，强行写会报ORA-30497
去重、空分隔符、空分组这些细节容易翻车
去重不是加个 DISTINCT 就完事；空分隔符看着省事，实际埋雷；空分组返回 NULL 也常被当默认空串处理。
-
LISTAGG(DISTINCT col, ',')在 19c 才原生支持，老库（如 11g/12c）必须先子查询去重：SELECT deptno, LISTAGG(ename, ',') WITHIN GROUP (...) FROM (SELECT DISTINCT deptno, ename FROM emp) GROUP BY deptno - 分隔符可以是空字符串
''，但会导致字段粘连（如abcde），不建议；NULL作为分隔符会报错 - 空分组（如 LEFT JOIN 右侧无记录）结果恒为
NULL，不会自动转成''，后续参与CONCAT或||拼接时整条变NULL -
ORDER BY中的NULLS LAST/NULLS FIRST要主动写，否则NULL默认排最前，可能打乱业务顺序
