listagg 必须写 within group (order by)，否则报 ora-30496；排序须在括号内，分隔符加单引号，超长触发 ora-01489，null 和重复需手动处理，空分组返回 null。
LISTAGG 必须写 WITHIN GROUP (ORDER BY)，否则直接报 ORA-30496
Oracle 不允许无序拼接，LISTAGG 语法强制要求 WITHIN GROUP (ORDER BY ...)，哪怕你只想要任意顺序——不写就报错，不是警告。常见错误是把 ORDER BY 写在外部查询里，比如：
SELECT LISTAGG(name, ',') FROM t ORDER BY name; -- ❌ 报 ORA-30496
正确写法必须把排序放进 WITHIN GROUP 里：
LISTAGG(name, ',') WITHIN GROUP (ORDER BY name)- 排序字段最好来自
GROUP BY或能被分组唯一确定，否则结果不稳定（例如按未分组的salary排序可能出错） - 分隔符是字符串字面量，必须加单引号：
','，不能写成,或comma
超长字符串会触发 ORA-01489，4000 字节是硬限制
Oracle 12c R1 及以前版本中，LISTAGG 返回类型固定为 VARCHAR2(4000)，超出就报 ORA-01489。12c R2 起支持 ON OVERFLOW TRUNCATE，但默认仍报错。
- 显式截断写法：
LISTAGG(col, ',') WITHIN GROUP (ORDER BY col) ON OVERFLOW TRUNCATE '...' WITH COUNT - 要完整结果，改用
XMLAGG+XMLELEMENT组合，返回CLOB：
SELECT RTRIM(XMLAGG(XMLELEMENT(e, col || ',')).EXTRACT('//text()').GETCLOBVAL(), ',') FROM t;
注意：不能靠把结果插入 CLOB 字段来绕过限制——LISTAGG 自身不升格类型，截断发生在函数执行阶段。
NULL 和重复值不会自动处理，得提前过滤
LISTAGG 默认保留 NULL，但拼接时转为空字符串，导致出现 a,,b 这类多逗号；也不去重，源数据重复，结果就重复。
- 过滤 NULL 最简单：
WHERE col IS NOT NULL - 去重必须在外层或子查询做：
SELECT LISTAGG(name, ',') WITHIN GROUP (ORDER BY name) FROM (SELECT DISTINCT name FROM t) - 若需按某字段取最新一条再聚合（如每个用户最新地址），得先用
ROW_NUMBER()或KEEP (DENSE_RANK LAST)预聚合
空分组返回 NULL，不是空字符串 ''
当 GROUP BY 后某组没有匹配行（比如 LEFT JOIN 的右表为空），LISTAGG 返回 NULL，不是 ''。这会影响后续字符串操作，比如 CONCAT('prefix', LISTAGG(...)) 会变 NULL。
稳妥做法是显式转换：NVL(LISTAGG(col, ','), 'N/A') 或 COALESCE(LISTAGG(col, ','), '')。别依赖数据库隐式行为，尤其在报表或接口输出场景下容易漏掉这个边界。
真正麻烦的是混合了长度限制、NULL 处理和分组逻辑的复杂查询——这时候建议先拆成子查询验证每一步，而不是堆砌所有逻辑到一个 LISTAGG 表达式里。
