MySQL存储过程如何解析JSON参数

JSON_EXTRACT 返回 NULL 的常见原因主要有三种：路径写错、目标值为空，以及字段本身就是 NULL。处理这类问题时，建议先使用 JSON_VALID 校验 JSON 是否合法，再通过 ->> 进行脱壳提取，并结合 JSON_CONTAINS_PATH 判断键是否存在。

JSON_EXTRACT 返回 NULL 怎么处理

通常不是函数本身异常，而是路径错误、值为空，或字段本身为 NULL。这三种情况都会静默返回 NULL，且不会报错。在存储过程中，一旦将 NULL 赋给 DECLARE 的非 NULL 变量，或者用于 IF v_age > 18 这类条件判断时，相关逻辑就可能失效。

• 先用 JSON_VALID(in_json) 确认入参是合法 JSON，否则后续提取没有意义
• 路径必须严格匹配，例如写成 '$.user.name'，但实际结构为 '$.profile.name'，结果会返回 NULL
• 提取裸值时应使用 ->> 或 JSON_UNQUOTE(JSON_EXTRACT(...))；如果只写 JSON_EXTRACT(...)，得到的是带引号的字符串，如 "张三"，后续使用 = '张三' 判断时不会成立
• 数组越界时也会返回 NULL，例如 '$[5]' 对应的数组实际只有 3 个元素，执行过程不会中断

如何安全提取 JSON 中的数字或字符串字段

不要依赖隐式转换。像 JSON_EXTRACT(in_json, '$.age') > 18 这类写法在存储过程中结果并不稳定，常见结果是 0 或 NULL。正确做法是先脱壳，再进行比较。

• 字符串字段可使用 in_json->>'$.name'，得到纯字符串 张三，可直接用于 =、LIKE 或字符串拼接
• 数字字段同样使用 in_json->>'$.age'，得到可参与算术运算的整数，而不是 JSON 类型的 25
• JSON_UNQUOTE(NULL) 仍然返回 NULL，可安全用于各种路径提取场景
• 如果字段可能缺失，建议先使用 JSON_CONTAINS_PATH(in_json, 'one', '$.email') 判断 key 是否存在，再决定是否提取

更新 JSON 字段时，为什么 JSON_SET 需要谨慎使用

JSON_SET 在存储过程中存在三个常见风险：字段本身为 NULL 时结果仍为 NULL；路径不存在时会直接新增键；并发写入时缺少锁保护。在多数业务场景下，优先使用 JSON_REPLACE 更稳妥。

• 仅修改已有 key 时，可使用 JSON_REPLACE(in_json, '$.status', 'done')，如果路径不存在则原样返回，不会污染原有结构
• 只有在确实需要新增或覆盖，并且已确认容错策略时，才考虑使用 JSON_SET，同时建议增加 IF JSON_CONTAINS_PATH(...) 作为前置判断
• 原子递增场景，例如计数器，可写为 JSON_SET(json_col, '$.count', COALESCE(json_col->>'$.count', 0) + 1)，以避免先查询后修改带来的竞态问题
• 如果字段本身为 NULL，那么 JSON_REPLACE(NULL, '$.x', 1) 依旧返回 NULL，因此调用前应先判断 IF json_col IS NOT NULL THEN ...

遍历 JSON 数组通常需要使用 WHILE 循环

在 MySQL 存储过程中，没有 FOR EACH 或 JSON_TABLE 可直接用于遍历数组，除非能够明确确认运行环境为 MySQL 8.0.4+。因此，更可靠的方式通常是手动编写 WHILE 循环。索引一旦写错，就容易提取到 NULL，且排查难度较高。

• 使用 JSON_LENGTH(json_array) 获取数组长度，注意其返回的是元素个数，而不是最大索引
• 循环变量 i 应从 0 开始，上限设置为 JSON_LENGTH(json_array) - 1，不要写成 <= JSON_LENGTH(...)
• 动态路径需通过拼接生成，例如 JSON_EXTRACT(json_array, CONCAT('$[', i, ']'))，每次循环都需要重新拼接路径
• 提取后建议使用 JSON_TYPE(item) 判断数据类型，避免将对象按字符串处理而引发隐式转换问题
• 较低版本如 MySQL 5.7 不支持 JSON_TABLE()，直接调用会报错 FUNCTION JSON_TABLE does not exist

还有一个容易被忽略的关键点：所有 JSON 提取操作都建立在“路径必须精确”和“类型必须一致”这两个前提之上。而在存储过程中，这两类问题通常不会给出明确的运行时提示。代码完成后，建议结合真实数据，逐一验证以下边界情况：NULL、空数组、路径错误，以及多层嵌套访问越界。否则即使表面上逻辑能够正常执行，实际上某些分支可能并未真正生效。