MySQL JSON_DEPTH 怎样计算对象和数组混合时的嵌套层数

我第一次用 JSON_DEPTH() 检查接口字段时，最容易误判的是“对象和数组各算一层，还是只数括号”。更稳妥的理解是：它返回 JSON 文档中最深路径的层数；标量、空数组和空对象都是 1，容器本身再加上它内部最深值的层数。官方参考地址：https://dev.mysql.com/doc/refman/8.4/en/json-attribute-functions.html

判断混合 JSON 的关键不是统计所有节点，而是找到从根到最深标量或容器的那条路径。每经过一层对象成员或数组元素，深度增加 1；并列的浅分支不会改变结果。

• 深度 1：标量、[]、{}。
• 深度 2：根容器直接放标量，或直接放空容器。
• 混合结构：比较所有分支，只取最深的一条。
• 异常边界：SQL 的 NULL 返回 NULL，无效 JSON 会报错。

先把 JSON_DEPTH 的“1”看成根值

JSON 文档的根值本身就占第 1 层，所以 JSON_DEPTH('true')、JSON_DEPTH('{}') 和 JSON_DEPTH('[]') 都是 1。根对象直接拥有一个数字成员时，路径是“对象 → 数字”，结果为 2；成员值如果还是对象或数组，就继续向下看。

-- 标量和空容器都只有根值这一层
SELECT JSON_DEPTH('true') AS scalar_depth,
       JSON_DEPTH('{}') AS empty_object_depth,
       JSON_DEPTH('[]') AS empty_array_depth;

-- 根对象直接包含标量，路径长度为 2
SELECT JSON_DEPTH('{"name":"go"}') AS object_with_scalar;

这里的“层”不是对象成员数量，也不是数组元素数量。一个数组里放 100 个标量，仍然只有根数组和元素两层，深度是 2。

对象和数组混合时沿最深路径计算

混合结构可以按“根值先记 1，进入下一层再加 1”的方式拆解。例如 [10,{"a":20}] 有两条分支：数字分支到第 2 层结束，对象分支继续经过对象成员到第 3 层，因此结果是 3。对象与数组的类型不会改变加层规则，改变结果的是最深路径。

-- 两个分支深度不同，JSON_DEPTH 取对象分支的最深值
SELECT JSON_DEPTH('[10, {"a": 20}]') AS mixed_depth;

-- 路径可读成：数组(1) -> 对象(2) -> 成员值(3)
SELECT JSON_DEPTH('{"items":[{"id":1}]}') AS nested_depth;

排查时可以先把 JSON 画成树，再逐条数根到叶子的路径。不要把同一层的兄弟节点重复累加，也不要因为数组中元素很多就把数量当成深度。

用对照 SQL 处理 NULL 和非法 JSON

写入表字段或接收接口参数时，我会把“没有值”和“值格式错误”分开处理。传入 SQL NULL 时函数返回 NULL；传入不是合法 JSON 的字符串则会产生错误，不能把它理解为深度 0。

-- NULL 表示没有 JSON 文档，结果也是 NULL
SELECT JSON_DEPTH(NULL) AS missing_document;

-- 合法 JSON 字符串可以计算；普通文本不是合法 JSON 文档
SELECT JSON_DEPTH('"hello"') AS json_string_depth;
-- 下面的输入会报错，不应拿来当作深度结果
SELECT JSON_DEPTH('hello') AS invalid_json;

如果应用层允许空值，先决定空值是否代表“未提交”；如果要求必须是 JSON，再在写入或查询入口处理格式错误。JSON_DEPTH() 只负责返回深度，不负责替你定义业务上的合法性策略。

常见问题

JSON_DEPTH 会统计所有对象成员吗？

不会。它关注最深嵌套路径，不是成员总数。并列成员再多，只要它们处于同一层，结果也不会因此增加。

数组和对象谁会让深度增加得更多？

两者在层级计算上没有优先级差异。数组元素和对象成员都表示进入下一层，最终看哪条路径更深。

为什么空对象不是 0？

因为 JSON 文档的根值本身计为 1。空对象虽然没有成员，仍然是一个完整的 JSON 根值。