array_agg必须配合group by使用，否则报错；不写order by时数组元素顺序不确定，生产环境需显式声明；空分组返回null，应使用coalesce兜底为空数组。
ARRAY_AGG 必须配合 GROUP BY 使用，否则直接报错；不写 ORDER BY 时数组元素顺序不确定，生产环境务必显式声明。
为什么 SELECT ARRAY_AGG(name) 不加 GROUP BY 就报错
PostgreSQL 把 ARRAY_AGG 当作标准聚合函数处理，和 COUNT 类似——但区别在于：COUNT(*) 允许无 GROUP BY（全表计数），而 ARRAY_AGG(name) 没有分组上下文时，数据库无法判断“把哪些行压进同一个数组”。常见错误信息是：ERROR: column "name" does not exist 或更直白的 ERROR: aggregate functions are not allowed in WHERE（哪怕你根本没写 WHERE）。
正确做法只有三种：
- 按业务字段分组：例如
SELECT dept, ARRAY_AGG(name) FROM employees GROUP BY dept - 多列组合分组：例如
SELECT dept, role, ARRAY_AGG(id) FROM employees GROUP BY dept, role - 强制全表聚合成单个数组：用恒真分组
GROUP BY ()，即SELECT ARRAY_AGG(name) FROM employees GROUP BY ()
ORDER BY 必须写在 ARRAY_AGG() 括号里，放外面无效
很多人写成 SELECT dept, ARRAY_AGG(name) FROM employees GROUP BY dept ORDER BY name，结果发现数组里元素还是乱序。这是因为外层 ORDER BY 只控制最终结果集的行顺序，不影响数组内部结构。
真正生效的排序必须嵌在函数参数中：
- 升序（默认）：
ARRAY_AGG(name ORDER BY name) - 降序且 NULL 排最后：
ARRAY_AGG(name ORDER BY name DESC NULLS LAST) - 按表达式排序（如字符串长度）：
ARRAY_AGG(name ORDER BY LENGTH(name), name)
不加 ORDER BY 时，PostgreSQL 不保证顺序——同一查询反复执行可能返回不同排列，前端渲染或校验逻辑容易出问题。
空分组返回 NULL，记得用 COALESCE 包一层
如果某组没有匹配行（比如 WHERE status = 'active' 但该 dept 下没人 active），ARRAY_AGG 直接返回 NULL，不是空数组 {}。这对应用层很不友好，尤其 Python 或 Django 解析时容易触发 NoneType 错误。
稳妥写法是兜底：
-
COALESCE(ARRAY_AGG(name), ARRAY[]::text[])→ 返回空数组 -
COALESCE(ARRAY_AGG(name), '{}')→ 更简短，但需注意类型推断是否准确（建议显式 cast）
别用 ARRAY_AGG(COALESCE(name, '')) 替代——这只是把 NULL 值转成空字符串，不能解决整组为空的问题。
array_agg(DISTINCT x) 有版本和类型限制
array_agg(DISTINCT x) 语法在 PostgreSQL 9.5+ 支持，但仅适用于标量输入（如 text、int）。如果 x 本身是数组类型（比如 tags text[]），这个写法会失败或静默忽略去重。
对数组字段去重，必须走展开路线：
SELECT ARRAY_AGG(DISTINCT elem) FROM (SELECT UNNEST(tags) AS elem FROM posts) t- 若原数组含 NULL 且想保留占位，得加
WITH ORDINALITY并手动补 NULL
另外，ARRAY_CAT 不是聚合函数，不能替代 ARRAY_AGG；它只拼两个已有数组，跨行聚合直接报错。
