MySQL的JSON_ARRAYAGG在无匹配行时返回NULL而非空数组[]，应使用COALESCE(JSON_ARRAYAGG(...), JSON_ARRAY())显式补空；它默认跳过NULL值、不自动去重，需用子查询加DISTINCT处理；嵌套对象必须用JSON_OBJECT显式构造，且8.0+才支持ORDER BY内联排序。
JSON_ARRAYAGG 生成空数组时返回 NULL 怎么办
MySQL 的 JSON_ARRAYAGG 在没有匹配行时返回 NULL，不是空数组 []，这常导致应用层解析失败或需要额外判空。直接用 COALESCE 包裹是最稳妥的解法：
-
COALESCE(JSON_ARRAYAGG(...), JSON_ARRAY())—— 显式补空数组，语义清晰 - 避免用
IFNULL(..., '[]')，因为字符串'[]'不是合法 JSON 类型，后续无法用JSON_CONTAINS等函数操作 - 注意：MySQL 5.7 不支持
JSON_ARRAY()（需 8.0+），低版本可用CAST('[]' AS JSON)
GROUP BY 后 JSON_ARRAYAGG 没去重怎么办
JSON_ARRAYAGG 默认不自动去重，重复值会原样堆进数组。如果业务需要唯一项，得提前在子查询或 CTE 中处理：
- 用
DISTINCT配合子查询：JSON_ARRAYAGG((SELECT JSON_ARRAYAGG(t.name) FROM (SELECT DISTINCT name FROM users WHERE dept_id = d.id) t)) - 不能直接写
JSON_ARRAYAGG(DISTINCT name)—— MySQL 不支持该语法（PostgreSQL 支持，但 MySQL 不行） - 若字段含
NULL，JSON_ARRAYAGG会跳过它；如需保留null元素，得用IFNULL(name, CAST(NULL AS JSON))
嵌套对象生成时字段别名丢失怎么修复
想把多列拼成 JSON 对象再聚合，常见错误是直接写 JSON_ARRAYAGG(ROW(col1, col2)) 或漏掉 AS 别名，结果得到无名字段的数组：
- 正确写法必须显式构造对象：
JSON_ARRAYAGG(JSON_OBJECT('id', id, 'title', title)) - 别名不生效是因为
JSON_OBJECT内部靠键名定义结构，外部 SELECT 别名不影响 JSON 内容 - 如果字段值含特殊字符或二进制数据，建议加
CAST(... AS CHAR)避免乱码或序列化失败
大数据量下 JSON_ARRAYAGG 内存溢出怎么调
当聚合行数超万级，JSON_ARRAYAGG 可能触发 group_concat_max_len 限制或内存耗尽，报错类似 Packet too large 或 Out of memory：
- 临时调高上限：
SET SESSION group_concat_max_len = 4294967295;（最大值，仅当前会话有效） - 更安全的做法是分页聚合：用
LIMIT+OFFSET分批查，应用层合并，避免单次大 JSON - 注意：该函数不支持
ORDER BY子句（MySQL 8.0.24+ 才支持），旧版本需用子查询先排序再聚合
NULL 和隐式类型转换——比如把整数字段直接塞进 JSON_OBJECT，结果变成字符串；或者没意识到 DISTINCT 在聚合函数里不生效。这些细节不试一次真不容易记住。 
