listagg的within group仅支持单表达式排序，但可写成order by col1, col2实现多级排序；混合升序降序需用函数转换；null须显式处理；超长需on overflow或xmlagg。
LISTAGG 的 WITHIN GROUP 子句只支持单列排序，不能直接写多列
Oracle 的 LISTAGG 函数在 12c 及以后版本中确实允许用 WITHIN GROUP (ORDER BY ...) 控制拼接顺序，但它语法上只接受一个排序表达式——这个表达式可以是列、函数调用或组合表达式，但不是“多列列表”意义上的多个 ORDER BY 子句。常见错误是试图写成 WITHIN GROUP (ORDER BY col1, col2)，这在语法上是合法的，但要注意：它等价于先按 col1 排、再按 col2 排，不是“分别对不同列做独立排序”。真正的问题往往出在语义误解或 NULL 处理上。
多字段组合排序必须显式构造排序键
如果你需要按多个逻辑条件决定拼接顺序（比如优先按状态升序，状态相同时按创建时间降序），就得把它们合成一个可比较的表达式。Oracle 不支持 ORDER BY col1 ASC, col2 DESC 这种混合方向写法（会报 ORA-30496），所以得靠函数绕过：
-
ORDER BY col1, col2 DESC是非法的；必须写成ORDER BY col1, -col2（仅适用于数值）或ORDER BY col1, TO_CHAR(col2, 'YYYYMMDDHH24MISS') DESC - 字符串字段想倒序？可用
ORDER BY col1, UTL_RAW.CAST_TO_RAW(col2) DESC，但更稳妥的是用ORDER BY col1, DBMS_RANDOM.VALUE()配合子查询模拟稳定逆序（不推荐） - 最通用做法：在子查询里提前计算排序权重，例如
SELECT ..., ROW_NUMBER() OVER (ORDER BY status, created_date DESC) AS sort_rank FROM t，再在LISTAGG中按sort_rank排
NULL 值会让排序结果不可控，必须显式处理
LISTAGG 的 WITHIN GROUP 默认把 NULL 当作最小值（类似 NULLS FIRST），但 Oracle 版本间行为有差异，12.1 之前甚至不保证稳定性。一旦排序字段含 NULL，拼接顺序可能每次执行都不一样：
- 强制指定
NULLS LAST或NULLS FIRST，例如ORDER BY col1 NULLS LAST, col2 NULLS FIRST - 用
NVL或COALESCE统一替换，如ORDER BY NVL(col1, 'ZZZZ'), col2（字符串场景） - 若业务上 NULL 应排末尾，且字段为日期，用
ORDER BY NVL(col_date, DATE '9999-12-31')更安全
超过 4000 字符会报 ORA-01489，必须提前截断或改用 XMLAGG
LISTAGG 默认返回 VARCHAR2(4000)，超长直接报错，不是静默截断。即使你加了 ON OVERFLOW TRUNCATE，也只从 Oracle 12.2 开始支持，且必须显式声明返回类型：
- 12.2+ 安全写法：
LISTAGG(col, ',') WITHIN GROUP (ORDER BY x) ON OVERFLOW TRUNCATE '...' WITH COUNT - 兼容旧版本？改用
XMLAGG(XMLELEMENT(E, col || ',')).EXTRACT('//text()').GETCLOBVAL()，再用RTRIM(..., ',')去尾逗号 - 注意
XMLAGG本身无排序能力，必须在外层子查询中先ORDER BY，否则结果随机
多列排序逻辑越复杂，越容易在 WITHIN GROUP 里埋下隐式类型转换或 NULL 漏洞，实际写的时候建议先用子查询把排序字段规整好，再喂给 LISTAGG。
