LISTAGG不是即用型函数，必须配合GROUP BY和WITHIN GROUP(ORDER BY)使用，否则报ORA-00937；默认返回VARCHAR2(4000)，超长抛ORA-01489，不自动截断；需显式CAST为CLOB或改用XMLAGG方可突破长度限制。
LISTAGG 不是“拿来就能用”的字符串拼接工具，它本质是聚合函数，必须配合分组和显式排序才能执行，否则直接报 ORA-00937。
LISTAGG 必须带 GROUP BY 和 WITHIN GROUP(ORDER BY)
裸写 SELECT LISTAGG(name, ',') 会立刻失败——Oracle 不允许聚合函数与非聚合列混用，也不接受无分组边界的聚合语义。
- 必须有
GROUP BY，哪怕只按一个常量分组（如GROUP BY 1） -
WITHIN GROUP (ORDER BY ...)是强制语法，不能写成WITH IN GROUP或漏掉括号 -
ORDER BY字段必须出现在GROUP BY列表中，或为确定性表达式（如ORDER BY name可行，ORDER BY sal在未按sal分组时会触发ORA-30497） - 若真不关心顺序，可用
ORDER BY NULL，但语义模糊，建议改用ORDER BY 1或明确字段
超长结果默认报错，不是自动截断
LISTAGG 默认返回 VARCHAR2，受 4000 字节硬限制。单组拼接超过该长度时，抛出 ORA-01489，而非静默丢数据。
- Oracle 12cR2+ 支持
ON OVERFLOW子句，但行为差异大：ON OVERFLOW ERROR（默认）、TRUNCATE '…'、TRUNCATE（无提示）、NULL - 生产环境慎用
TRUNCATE无参数形式——结果无声消失，排查困难 - 若需稳定支持长文本，应在查询中显式
CAST(LISTAGG(...) AS CLOB)，否则即使源数据够长，插入目标CLOB字段时仍卡在隐式转换阶段
NULL 和重复值不会自动处理
LISTAGG 默认跳过 NULL 值；整组全 NULL 时返回 NULL；它也不内置去重逻辑（19c 的 LISTAGG(DISTINCT ...) 属实验性语法，低版本不可用）。
- 把
NULL显式转为占位符：用NVL(name, '(unknown)')或COALESCE(name, '(unknown)')包裹后再进LISTAGG - 去重必须前置：19c 以下只能套子查询，如
SELECT dept_id, LISTAGG(name, ', ') WITHIN GROUP (ORDER BY name) FROM (SELECT DISTINCT dept_id, name FROM t) GROUP BY dept_id - 分隔符为空字符串（
LISTAGG(name, '')）会导致值粘连，务必显式传入有意义的分隔符
在 INSERT 或游标中使用要特别注意类型匹配
当把 LISTAGG 结果用于 INSERT INTO ... SELECT ...，或在 PL/SQL 游标中接收时，字段类型不匹配是最隐蔽的失败点。
- 目标列定义为
CLOB，但LISTAGG没CAST，插入时仍按VARCHAR2处理，超长即报错 - 游标中声明的变量类型必须与查询结果一致：用
CLOB接收比用VARCHAR2(4000)更安全 - 避免在游标主查询里直接混用非聚合列和
LISTAGG，应拆成子查询关联，例如用JOIN (SELECT deptno, LISTAGG(...) FROM emp GROUP BY deptno)方式
