LISTAGG基本用法必须配合GROUP BY，且WITHIN GROUP(ORDER BY ...)不可省略；排序字段须在SELECT或GROUP BY中，否则报ORA-30496；默认最大长度4000字节，超长报ORA-01489。
Oracle中LISTAGG的基本用法和必要条件
LISTAGG不是万能拼接函数，它必须配合GROUP BY使用，否则会报ORA-00937: not a single-group group function。你不能在没分组的查询里直接写SELECT LISTAGG(name, ',') FROM emp——这会失败。
常见写法是：SELECT deptno, LISTAGG(ename, ',') WITHIN GROUP (ORDER BY ename) AS names FROM emp GROUP BY deptno。注意两个关键点：WITHIN GROUP (ORDER BY ...)不可省略（否则语法错误），且ORDER BY里的字段必须是SELECT或GROUP BY中的列。
- 如果排序字段不在
GROUP BY里，又没出现在SELECT列表中，Oracle 12c+ 会报ORA-30496: Argument should be a constant or a function of GROUP BY variables -
LISTAGG默认最大长度为4000字节（VARCHAR2限制），超长会报ORA-01489: result of string concatenation is too long - Oracle 12cR2 起支持
ON OVERFLOW TRUNCATE子句，但截断不带提示，慎用
把多行合并结果插入单行：INSERT … SELECT + LISTAGG组合
想把某张表中按order_id分组的多个item_name合并成一个逗号分隔字符串，再插入到另一张汇总表，直接写INSERT INTO summary (order_id, items) SELECT order_id, LISTAGG(item_name, ',') WITHIN GROUP (ORDER BY item_name) FROM detail GROUP BY order_id即可。
但要注意目标字段类型：如果summary.items是VARCHAR2(100)，而拼接结果超长，插入时会报ORA-01401: inserted value too large for column，不是LISTAGG报错，而是INSERT阶段截断失败。
- 建议目标列用
VARCHAR2(4000)起步，或改用CLOB（需搭配CAST(LISTAGG(...) AS CLOB)） - 若源数据含
NULL，LISTAGG默认跳过，无需额外NVL；但若想把NULL转成'(unknown)'，得先COALESCE(item_name, '(unknown)') - 分组键（如
order_id）必须明确出现在SELECT和GROUP BY中，少一个就报错
替代方案：当LISTAGG不适用时该用什么
如果要拼接的数据量极大（比如单组超万行）、或需要去重、或需兼容老版本Oracle（LISTAGG就不是最优解。
WM_CONCAT虽快但非官方函数，12c起已废弃，生产环境禁止使用；XMLAGG更稳定，但语法绕：用RTRIM(XMLAGG(XMLELEMENT(e, ename || ',')).EXTRACT('//text()'), ',')，性能略差，且对特殊字符（如、<code>&）会自动转义。
- 去重拼接必须套子查询：
LISTAGG(ename, ',') WITHIN GROUP (ORDER BY ename)从(SELECT DISTINCT ename FROM emp WHERE ...)中取 - Oracle 19c+ 可用
STRING_AGG（ANSI标准函数），但需确认兼容模式，且仍需GROUP BY - 若拼接逻辑复杂（如加前缀、条件过滤），优先考虑用PL/SQL写过程，别硬塞进单条SQL
容易被忽略的字符集与空格问题
LISTAGG对空格极其敏感：如果ename字段尾部有空格（CHAR类型常见），拼出来就是'Alice ,Bob ,Charlie '——看着像bug，其实是数据本身带空格。用RTRIM(ename)预处理最稳妥。
另一个坑是字符集：数据库字符集为AL32UTF8时，中文字符占3字节，4000字节上限实际撑不满1333个汉字。如果拼接后总长度接近临界值，用LENGTHB(LISTAGG(...))检查字节长度比LENGTH更准确。
- 不要依赖
TO_CHAR或CONVERT临时“修复”长度，它们不改变LISTAGG内部计算逻辑 - 开发时用
SELECT DUMP(LISTAGG(...)) FROM ...看实际字节构成，比猜靠谱 - 上线前务必用真实数据量压测，小数据OK不代表大批量不崩
