listagg必须配合group by和within group使用，否则报ora-00937；默认varchar2限4000字节，超长需on overflow或cast为clob；null默认跳过，去重需distinct或子查询。
LISTAGG必须配GROUP BY和WITHIN GROUP，否则直接报错
你不能写 SELECT LISTAGG(name, ',') 这种裸用形式——Oracle 会立刻抛出 ORA-00937: not a single-group group function。它本质是聚合函数，必须明确分组边界。
常见错误场景包括：漏写 GROUP BY、WITHIN GROUP (ORDER BY ...) 拼错成 WITH IN GROUP 或干脆省略、排序字段不在 SELECT 或 GROUP BY 列表里（触发 ORA-30496）。
- 正确写法必须同时包含：
GROUP BY dept_id+LISTAGG(emp_name, ', ') WITHIN GROUP (ORDER BY emp_name) - 哪怕不关心顺序，也得显式写
ORDER BY 1或ORDER BY NULL（后者语义模糊，不推荐） - 如果分组键是表达式（如
TRUNC(order_date)），它必须原样出现在GROUP BY和SELECT中
超长字符串处理：4000字节限制与ON OVERFLOW选项
LISTAGG 默认返回 VARCHAR2，受 4000 字节上限约束。单组拼接结果超长时，不是警告，而是硬报错 ORA-01489。
Oracle 12cR2 起支持 ON OVERFLOW 子句，但行为差异大，选错容易丢数据：
-
ON OVERFLOW ERROR：默认行为，报错中断（最安全） -
ON OVERFLOW TRUNCATE '…'：截断并追加指定字符串，注意预留长度（比如分隔符+省略号占 3 字节） -
ON OVERFLOW TRUNCATE（无参数）：静默截断，无提示，极易漏检 -
ON OVERFLOW NULL：整组结果变NULL，适合强校验流程
若确定需要突破 4000 限制，目标列定义为 CLOB，并显式 CAST(LISTAGG(...) AS CLOB) —— 否则即使源数据够长，插入时仍卡在 VARCHAR2 截断上。
NULL 值与去重：LISTAGG 本身不处理，得靠前置转换
LISTAGG 默认跳过 NULL，整组全 NULL 时返回 NULL；它也不支持内置 DISTINCT（19c 才加实验性支持，生产环境慎用）。
实际业务中常需显式控制：
- 把
NULL显为'(unknown)'：用NVL(emp_name, '(unknown)')或COALESCE(emp_name, '(unknown)')包裹后再进LISTAGG - 去重必须提前做：Oracle 19c 可写
LISTAGG(DISTINCT emp_name, ', ')，但低版本只能套子查询SELECT ... FROM (SELECT DISTINCT dept_id, emp_name FROM t) - 分隔符为空字符串时，结果会粘连（如
LISTAGG(name)→AliceBob），务必显式传入分隔符
INSERT 场景下最容易被忽略的字段类型匹配
用 INSERT INTO summary SELECT ... LISTAGG(...) FROM detail GROUP BY ... 时，失败往往不在 LISTAGG 阶段，而在插入瞬间。
典型陷阱：
- 目标列是
VARCHAR2(100)，但拼接结果 3200 字节 → 报ORA-01401: inserted value too large for column - 没开
ON OVERFLOW，但源数据波动导致某天突然超长，批量任务崩掉 - 用
TO_CHAR(date_col, 'YYYY-MM-DD')拼日期，忘了格式化后长度翻倍（如带空格、逗号）
建议：汇总表字段起步设为 VARCHAR2(4000)，或直接定义为 CLOB 并配合 CAST；上线前用 LENGTHB(LISTAGG(...)) 检查最大可能长度。
