PostgreSQL 15如何使用STRING_AGG函数拼接分组数据

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，别试图直接聚合数组