STRING_AGG必须指定非NULL分隔符且排序需在函数内显式声明;它自动跳过NULL但保留空字符串,应优先于array_agg+array_to_string,处理数组字段需先unnest。

STRING_AGG 语法必须带分隔符,不能省略或传 NULL
PostgreSQL 15 中 STRING_AGG 的第二个参数是**强制位置参数**,必须提供非 NULL 字符串。漏写、写成 NULL 或用 COALESCE(sep, ',') 动态 fallback 都会直接报错:ERROR: delimiter must not be null。
- 正确写法:
STRING_AGG(name, ', ')、STRING_AGG(tag, E'\n') - 错误写法:
STRING_AGG(name, NULL)、STRING_AGG(name, '')(空字符串合法,但结果无间隔)、STRING_AGG(name)(少参数) - 想动态控制分隔符?先在 WHERE 或 CASE 中预处理,不要试图绕过必填约束
排序必须显式声明,ORDER BY 要写在括号内
PostgreSQL 15 不保证拼接顺序,即使表有主键或插入顺序一致,也不代表查询结果稳定。不加 ORDER BY 的 STRING_AGG 在并行执行、数据重分布或升级后可能突然乱序。
- 正确写法:
STRING_AGG(name, ', ' ORDER BY created_at DESC)(注意括号包裹整个表达式) - 错误写法:
STRING_AGG(name, ', ') ORDER BY created_at(这是对整行排序,不是对聚合内部排序) - 多字段排序支持:
STRING_AGG(name, ', ' ORDER BY status, id) - NULL 值默认排最前,需加
NULLS LAST控制位置,例如:ORDER BY score NULLS LAST
NULL 值默认被跳过,空字符串却会被保留
STRING_AGG 对 NULL 是静默过滤,但对空字符串 '' 完全不处理——它会被当作有效值参与拼接,导致结果中出现多余分隔符,比如 北京、、上海。
- 过滤空字符串:
STRING_AGG(CASE WHEN city = '' THEN NULL ELSE city END, '、') - 把 NULL 显式转成占位符:
STRING_AGG(COALESCE(city, '(unknown)'), '、') - 空组(所有输入都是 NULL)返回
NULL,如需空字符串,外层套COALESCE(..., '') - 别用
FILTER (WHERE col IS NOT NULL)—— 这是冗余操作,STRING_AGG本就不吃 NULL
别用 array_agg + array_to_string,性能和语义都更差
虽然 array_agg 看似灵活,但在 PostgreSQL 15 中,它比 STRING_AGG 多一次内存分配和类型转换,执行计划更重,且行为不一致:
-
array_agg会把NULL当作数组元素存进去,array_to_string可能崩或输出NULL;STRING_AGG直接跳过 -
array_agg排序必须套子查询或窗口函数;STRING_AGG支持原生ORDER BY子句 -
array_to_string分隔符参数可选,默认为空字符串,容易引发格式隐患;STRING_AGG强制你面对分隔意图 - 字段是数组类型(如
text[])?先unnest()展开,再用STRING_AGG,别试图直接聚合数组

















