LISTAGG报ORA-01489因VARCHAR2硬上限4000字节，12cR2起支持CLOB但需显式声明；ON OVERFLOW TRUNCATE可截断保执行，XMLAGG+GETCLOBVAL能获取完整结果，自定义函数需防SQL注入与空值风险。
直接用 ON OVERFLOW TRUNCATE 最省事，但数据不全；真要保完整，得换 XMLAGG 或自定义函数。
LISTAGG 报 ORA-01489 的根本原因
Oracle 12c 之前，LISTAGG 返回类型固定是 VARCHAR2，硬上限 4000 字节（AL32UTF8 下可能更少）。哪怕你只拼 100 个中文名，每个占 3 字节，加逗号也容易超。12cR2 起虽支持 CLOB 返回，但默认仍走 VARCHAR2 路径，除非显式声明或用替代方案。
常见错误现象就是执行时直接报：ORA-01489: result of string concatenation is too long。
别指望改数据库参数绕过——这个限制在函数签名层就锁死了。
用 ON OVERFLOW TRUNCATE 快速兜底
这是 Oracle 原生支持的“止损”语法，适合对完整性要求不高、只要不崩的场景（比如前端预览、日志摘要）。
-
ON OVERFLOW TRUNCATE：截断超长部分，末尾不补分隔符 -
ON OVERFLOW TRUNCATE '...' WITH COUNT：截断后加省略号，并附上被截掉的行数 - 必须跟在
WITHIN GROUP后面，不能单独用
示例：
SELECT department_id,
LISTAGG(employee_name, ', ')
WITHIN GROUP (ORDER BY employee_id)
ON OVERFLOW TRUNCATE '…' WITH COUNT AS names
FROM employees
GROUP BY department_id;
注意：WITH COUNT 返回的是整数，会自动转成字符串拼在末尾，比如 张三, 李四, … (2)。
用 XMLAGG + GETCLOBVAL 获取完整结果
这是最常用、无需额外权限、兼容性最好的完整方案。原理是借 XMLAGG 返回 XMLTYPE，再用 GETCLOBVAL() 转成 CLOB，突破 4000 字节墙。
关键点：
- 必须用
XMLELEMENT包裹字段，再.EXTRACT('//text()')提纯文本，否则会带 XML 标签 -
RTRIM是为了干掉最后多出来的一个分隔符 - 排序靠
ORDER BY写在XMLAGG里，不是外面
示例：
SELECT department_id,
RTRIM(
XMLAGG(XMLELEMENT(e, employee_name || ', ')
ORDER BY employee_id).EXTRACT('//text()').GETCLOBVAL(),
', '
) AS names
FROM employees
GROUP BY department_id;
性能比原生 LISTAGG 略低，但对几万行以内基本无感；超过百万行建议加索引或分批处理。
自定义函数 listagg_func 的坑与配置
如果你需要动态 SQL（比如拼接条件来自参数）、或必须返回 CLOB 且不能改现有 SQL 结构，才考虑写函数。但要注意几个硬伤：
- 函数里用
REF CURSOR执行传入的 SQL，意味着无法使用绑定变量，SQL 注入风险必须由调用方兜底 - 没做空值处理：如果某行
employee_name是NULL，FETCH进来就是空字符串，可能拼出多余逗号 - 没处理分隔符为空的情况，
symbol_in传NULL会导致第一次循环就拼错 - 函数需
CREATE FUNCTION权限，且调用时不能在视图或物化视图定义中直接引用
最小可用版修正建议：
CREATE OR REPLACE FUNCTION listagg_func(sql_in IN VARCHAR2, symbol_in IN VARCHAR2 DEFAULT ', ')
RETURN CLOB IS
v_result CLOB;
v_msg VARCHAR2(32767);
TYPE temp IS REF CURSOR;
cur_query temp;
BEGIN
DBMS_LOB.CREATETEMPORARY(v_result, TRUE);
OPEN cur_query FOR sql_in;
LOOP
FETCH cur_query INTO v_msg;
EXIT WHEN cur_query%NOTFOUND;
IF v_msg IS NOT NULL THEN
IF DBMS_LOB.GETLENGTH(v_result) = 0 THEN
v_result := v_msg;
ELSE
v_result := v_result || symbol_in || v_msg;
END IF;
END IF;
END LOOP;
CLOSE cur_query;
RETURN v_result;
END;
调用时务必确保 sql_in 是单列查询，且字段非空或已 NVL 处理——这点最容易被忽略。
