LISTAGG本身不支持去重，必须手动预处理：典型做法是子查询中用SELECT DISTINCT + ORDER BY确保输入唯一且有序；Oracle 19c+可用STRING_AGG(DISTINCT...)天然支持去重与排序。
LISTAGG 本身不支持去重，必须手动预处理
LISTAGG 是 Oracle 11g+ 提供的字符串聚合函数，但它对输入数据不做任何 deduplication 或排序——它只忠实地拼接结果集中的每一行。如果你直接写 LISTAGG(col, ',')，重复值照常出现，顺序也取决于查询执行时的物理/逻辑访问路径（通常无序）。常见错误现象是：明明源数据有重复，聚合后字符串里一堆重复项；或者每次执行结果顺序不一致，导致应用层比对失败。
解决思路很明确：把去重和排序这俩动作提前到 LISTAGG 的输入子查询里完成。典型做法是用 SELECT DISTINCT + ORDER BY 子句嵌套在内联视图中：
SELECT LISTAGG(name, ',') WITHIN GROUP (ORDER BY name) FROM ( SELECT DISTINCT name FROM employees WHERE dept = 'ENG' ORDER BY name -- 这个 ORDER BY 对 LISTAGG 输入顺序有效 );
注意：WITHIN GROUP (ORDER BY ...) 是 LISTAGG 自己的排序语法，它只控制最终拼接顺序，不影响去重；而子查询里的 ORDER BY 在 Oracle 中虽非必需（因 DISTINCT 可能触发排序），但显式写出更可靠，尤其当后续加 ROWNUM 或分页时。
Oracle 19c+ 可用 STRING_AGG 替代，但语法细节不同
从 Oracle 19c 开始引入了标准 SQL 兼容的 STRING_AGG，它支持 DISTINCT 关键字，写法更简洁：
SELECT STRING_AGG(DISTINCT name, ',' ORDER BY name) FROM employees WHERE dept = 'ENG';
这个语句天然去重 + 排序，无需子查询。但要注意三点：
-
STRING_AGG不接受WITHIN GROUP语法，排序必须写在函数参数里（ORDER BY紧跟在分隔符后） - 它只在 19c 及以上版本可用，低版本会报
ORA-00904: "STRING_AGG": invalid identifier - 如果字段含
NULL，STRING_AGG默认忽略（和LISTAGG一致），无需额外WHERE name IS NOT NULL
去重逻辑复杂时，别硬塞进 LISTAGG，改用 MODEL 或递归 WITH
当“去重”不是简单 DISTINCT，而是按业务规则（比如保留最新时间戳的那条、或按优先级取第一个），强行用子查询 + LISTAGG 容易写出难以维护的嵌套。这时候应该先用分析函数筛出唯一行，再聚合：
SELECT LISTAGG(name, ',') WITHIN GROUP (ORDER BY priority)
FROM (
SELECT name,
ROW_NUMBER() OVER (PARTITION BY name ORDER BY updated_ts DESC) rn,
RANK() OVER (ORDER BY priority) priority
FROM employees
)
WHERE rn = 1;
这种写法比在 LISTAGG 外再套一层 GROUP BY 更可控。容易踩的坑是：在子查询里漏掉 ORDER BY 导致 ROW_NUMBER() 结果不稳定；或者把 priority 放错层级，造成聚合顺序错乱。
字符超长截断风险必须主动处理
LISTAGG 默认最大长度是 4000 字节（VARCHAR2 限制），超过就报 ORA-01489: result of string concatenation is too long。即使你已去重排序，数据量大时仍可能超限。不能依赖“反正去重了就短”，得主动防御：
- 用
ON OVERFLOW TRUNCATE（12cR2+）快速兜底：LISTAGG(name, ',' ON OVERFLOW TRUNCATE '...' WITH COUNT) - 更稳妥的是先估算上限：
COUNT(*) * (MAX(LENGTH(name)) + 1)，结合分隔符长度预判是否可能溢出 - 若必须完整返回，改用
XMLAGG+XMLELEMENT组合（返回 CLOB），但性能略低，且需额外REPLACE清洗 XML 标签
实际开发中最容易被忽略的，是把去重排序当成纯 SQL 语法问题来解，而没检查上游数据质量——比如空格、不可见字符、大小写混用导致的“看似重复实则不同”。这类问题光靠 DISTINCT 拦不住，得前置 TRIM(UPPER()) 或正则清洗。
