listagg必须配合group by和within group(order by...)使用，漏写或错放order by会报ora-30497；遇null值整行结果变null，非跳过；超长默认报ora-01489，12cr2起支持on overflow truncate。
LISTAGG 必须配合 GROUP BY 和 WITHIN GROUP (ORDER BY ...) 才能用，漏写 ORDER BY 或放错位置会直接报错，不是警告。
LISTAGG 的语法强制要求 ORDER BY 写在 WITHIN GROUP 里
很多人写成 SELECT LISTAGG(name, ',') FROM t ORDER BY name，这会触发 ORA-30496。Oracle 不允许无序拼接，WITHIN GROUP (ORDER BY ...) 是语法硬性要求，哪怕你只想要“任意稳定顺序”，也得显式写个字段（比如主键或时间戳）。
-
LISTAGG(name, ', ') WITHIN GROUP (ORDER BY id)✅ 合法 -
LISTAGG(name, ', ') WITHIN GROUP (ORDER BY UPPER(name))✅ 支持表达式，但不能含子查询或窗口函数 -
LISTAGG(name, ', ') OVER (PARTITION BY dept)❌ 报ORA-30497，LISTAGG 本身不支持直接作为分析函数
NULL 值会让整个分组结果变 NULL，不是跳过
和 COUNT 或 SUM 不同，LISTAGG 遇到任一输入为 NULL，整行聚合结果就是 NULL——这是“污染”行为，极易被忽略。
- 用
NVL(col, '')或COALESCE(col, '')把 NULL 转为空字符串，避免结果崩掉 - 如果空字符串参与拼接后留下多余分隔符（如
a,,b），需额外套TRIM或正则清理 - 更彻底的做法是提前过滤：
WHERE col IS NOT NULL，但要注意业务是否允许丢数据
超长字符串默认报 ORA-01489，靠 CAST 或 CLOB 字段定义绕不过去
Oracle 12cR1 及以前版本中，LISTAGG 返回类型固定为 VARCHAR2(4000)，超出就炸，且这个限制发生在函数执行阶段，不是存储阶段。
- 加
ON OVERFLOW TRUNCATE '' WITH COUNT显式启用截断（12cR2+ 才支持） - 要完整结果，必须换方案：
XMLAGG(XMLELEMENT(e, col || ','))+EXTRACT(...).GETCLOBVAL()，返回 CLOB，但性能略低、结果带 XML 标签需剥离 - 别指望把目标列设成 CLOB 就能自动升格——
LISTAGG自身不响应列类型，只认内部硬编码长度
空分组返回 NULL，不是空字符串 ''
比如 LEFT JOIN 后右表无匹配行，LISTAGG 结果就是 NULL，不是 ''。后续做 CONCAT('prefix', LISTAGG(...)) 会整体变 NULL。
- 稳妥做法是外层包一层
NVL(LISTAGG(...), '')或COALESCE(LISTAGG(...), 'N/A') - 注意：去重必须在子查询里做，
LISTAGG(DISTINCT col, ',')在早期版本不支持，19c 才引入，老库得先SELECT DISTINCT再聚合
最容易被忽略的是 ORDER BY 的作用域——它只影响拼接顺序，和外部查询的排序完全无关；还有 NULL 的“污染性”，看起来像跳过，实则是让整行失效。这两个点不处理，上线后查半天都找不到原因。
