LISTAGG在游标中需配合GROUP BY或子查询使用，否则报ORA-00937；超长需显式ON OVERFLOW处理；ORDER BY字段须在GROUP BY中；PL/SQL中建议用CLOB接收以防截断。
LISTAGG 在游标里直接用会报 ORA-00937 错误
因为 listagg 是聚合函数，游标中若没加 group by 或放在子查询里，oracle 会认为它和非聚合列混用，直接拒绝执行。常见错误信息就是 ora-00937: not a single-group group function。
实际场景比如：你想查每个部门的员工姓名拼成一行，但又想同时返回部门编号、部门名——这就必须分层处理。
- 要么把
LISTAGG放进子查询或内联视图，主查询只负责关联 - 要么在游标外用 PL/SQL 循环拼接（不推荐，性能差）
- Oracle 12c 及以上可考虑
MATCH_RECOGNIZE替代，但复杂度陡增，一般没必要
示例写法（安全可用）：
SELECT d.deptno, d.dname, e.ename_list FROM dept d JOIN ( SELECT deptno, LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) AS ename_list FROM emp GROUP BY deptno ) e ON d.deptno = e.deptno;
LISTAGG 超长截断要主动加 ON OVERFLOW
默认情况下，LISTAGG 超过 4000 字节（VARCHAR2 上限）就直接报错 ORA-01489: result of string concatenation is too long，不是静默截断。很多人以为它像 SUBSTR 一样“自动切”，其实不会。
必须显式声明溢出行为，否则游标一跑就崩。
-
ON OVERFLOW TRUNCATE：截断并可选加省略标记，比如ON OVERFLOW TRUNCATE '...' WITH COUNT -
ON OVERFLOW ERROR（默认）：直接报错，不给机会 - 注意：
ON OVERFLOW是 12c 才支持的语法，11g 及更早版本只能靠子查询 +ROWNUM限制条数，或改用自定义聚合函数
示例（12c+ 安全写法）：
LISTAGG(ename, ', ') WITHIN GROUP (ORDER BY ename) ON OVERFLOW TRUNCATE '...'
游标中 LISTAGG 的 ORDER BY 必须和分组键一致
WITHIN GROUP (ORDER BY ...) 里的字段，不能引用游标外部作用域的别名，也不能用表达式（如 UPPER(ename)）除非该表达式也出现在 GROUP BY 子句中。否则 Oracle 会报 ORA-30497: Argument should be a constant or a function of GROUP BY variables。
本质是：排序依据必须能被分组唯一确定，否则聚合结果不稳定。
- 允许：
LISTAGG(ename, ',') WITHIN GROUP (ORDER BY ename)（ename在GROUP BY里） - 不允许：
LISTAGG(ename, ',') WITHIN GROUP (ORDER BY sal)（sal没在GROUP BY，且一个部门有多人时 sal 不唯一） - 如果真要按薪资排，得先用分析函数预处理，或在子查询里
ROW_NUMBER() OVER (PARTITION BY deptno ORDER BY sal)再拼接
PL/SQL 游标变量绑定 LISTAGG 结果要注意数据类型
虽然 SQL 层 LISTAGG 返回 VARCHAR2，但 PL/SQL 中用 REF CURSOR 接收时，如果目标变量声明为 VARCHAR2(4000)，而实际结果超长（哪怕用了 ON OVERFLOW TRUNCATE），仍可能触发隐式转换失败或截断无声丢失。
更稳妥的做法是统一用 CLOB 接收，尤其当拼接内容来自描述性字段（如备注、标签列表）时。
- 声明游标变量时，确保对应列在
FETCH到的记录类型中是CLOB，而非VARCHAR2 - 若用
DBMS_SQL动态解析，需调用DEFINE_COLUMN显式指定CLOB类型 - 注意：
LISTAGG默认返回VARCHAR2，即使输入是CLOB，所以不要指望它自动升格；真要 CLOB 输出，得套一层TO_CLOB(LISTAGG(...))（12c+）
容易被忽略的一点：不同客户端（如 SQL*Plus、SQL Developer、JDBC）对 CLOB 的显示和绑定策略不同，测试时务必用真实调用链路验证，不能只看 SQL 窗口输出。
