json_arrayagg不会自动去重,且默认跳过null值;必须显式使用order by子句控制数组内元素顺序,嵌套对象需配合json_object,去重需借助distinct或子查询预处理。

JSON_ARRAYAGG 会自动去重吗?不会,但 NULL 值会被跳过
很多人以为 JSON_ARRAYAGG 类似 GROUP_CONCAT,会默认去重或保留所有行——其实它既不去重,也不报错,只是安静地把每一行的表达式结果塞进数组。唯一例外是:如果某行计算出的值为 NULL,那一项直接被忽略,不会生成 null 元素。
常见错误现象:明明查出 5 行数据,JSON_ARRAYAGG 却只返回长度为 3 的数组。大概率是其中两行的字段或表达式求值为 NULL。
- 用
IFNULL(col, 'N/A')或COALESCE(col, '')显式兜底,避免意外丢数据 - 若真需要保留
null元素,得手动包装:例如JSON_ARRAYAGG(JSON_OBJECT('id', id, 'name', IFNULL(name, NULL)))—— 注意这里IFNULL(name, NULL)看似冗余,实则是确保name字段即使为NULL,也会在对象中显式写出"name": null
想按指定顺序生成数组?必须配合 ORDER BY 子句
JSON_ARRAYAGG 本身不保证顺序。MySQL 8.0 要求显式声明排序逻辑,否则结果顺序由执行计划决定,可能每次查询都不一样。
使用场景:合并用户订单列表时,希望最新订单排在数组最前面;或按字母序拼接标签名。
- 语法必须写成:
JSON_ARRAYAGG(col ORDER BY created_at DESC),ORDER BY是子句,不是函数参数 - 支持多字段排序:
JSON_ARRAYAGG(id ORDER BY status ASC, updated_at DESC) - 不能在外部
ORDER BY影响其内部顺序 —— 外层排序只影响结果集行序,不影响数组内元素顺序
嵌套 JSON 对象怎么拼?用 JSON_OBJECT 包一层再聚合
单纯 JSON_ARRAYAGG(name) 只能得到字符串数组(如 ["Alice", "Bob"]),但多数业务需要对象数组(如 [{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}])。
性能影响:每调用一次 JSON_OBJECT 都有额外序列化开销,大数据量时比纯字段聚合慢 10%–20%,但可读性和后续解析成本低得多。
- 正确写法:
JSON_ARRAYAGG(JSON_OBJECT('id', id, 'name', name)) - 键名必须是字符串字面量,不能用变量或列别名:
JSON_OBJECT(col_name, value)是错的,会报Invalid JSON path expression - 若某个字段可能为
NULL,且你希望对象中仍保留该 key(值为null),就别用IFNULL替换,直接传原字段即可
遇到 “This function has none of DETERMINISTIC…” 错误?检查是否在视图或存储函数里用了它
MySQL 8.0 对含非确定性函数的视图/存储程序有严格限制。JSON_ARRAYAGG 被标记为 NOT DETERMINISTIC,所以在创建视图时若未显式声明 SQL SECURITY DEFINER 或未加 DETERMINISTIC 提示(实际不能加),就会报这个错。
典型错误信息:This function has none of DETERMINISTIC, NO SQL, or READS SQL DATA in its declaration and binary logging is enabled
- 创建视图时,加上
SQL SECURITY DEFINER:CREATE ALGORITHM=MERGE SQL SECURITY DEFINER VIEW user_orders AS SELECT user_id, JSON_ARRAYAGG(...) FROM orders GROUP BY user_id;
- 如果在存储函数中使用,必须声明
READS SQL DATA(不能写DETERMINISTIC,因为它确实不是) - 临时绕过办法:用派生表包裹聚合逻辑,让外层视图不直接依赖
JSON_ARRAYAGG
ORDER BY 必须写在 JSON_ARRAYAGG 内部、以及 NULL 值静默丢失这两点——尤其是做数据校验或分页聚合时,差一条记录都可能引发上游解析失败。











