JSON_SEARCH仅返回匹配路径字符串，不提取值，且对大小写和结构敏感；需配合JSON_UNQUOTE或JSON_TABLE才能可靠提取目标值，直接用于JSON_EXTRACT会因引号问题失败。
JSON_SEARCH 可以定位值在 JSON 文档中的路径，但必须注意它只返回路径字符串，不提取值本身，且对大小写和结构敏感。
JSON_SEARCH 的基本用法和参数含义
函数签名是 JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path]])。第一个参数是 JSON 字段或字面量；第二个参数决定匹配策略：one 返回首个匹配路径，all 返回所有路径（用逗号分隔的 JSON 数组）；第三个参数是要搜索的字符串值（注意：只能是字符串，数字或布尔值会被隐式转成字符串再比对）；后两个参数可选，用于自定义转义符和限定搜索范围的起始路径。
常见错误现象包括：JSON_SEARCH 对 123 和 "123" 视为不同值；搜索 true 时必须写 'true'（小写字符串）；若字段存的是整数型 JSON 值，而你搜 '123'，可能意外命中——因为 JSON 类型校验不阻止字符串与数字的模糊匹配，但结果不可靠。
- 搜索整个文档：省略最后一个
path参数，如JSON_SEARCH(data, 'one', 'admin') - 限定在某个子结构里搜：显式传入路径，如
JSON_SEARCH(data, 'one', 'admin', NULL, '$.users[*].role') - 路径中含点号或特殊字符？用括号表示法写路径，例如
$['user.name']，但JSON_SEARCH的path参数本身不支持括号语法，只能用点号或[*]等标准路径组件
为什么 JSON_SEARCH 返回的路径不能直接喂给 JSON_EXTRACT？
因为 JSON_SEARCH 返回的是带双引号的 JSON 字符串，比如 "$.items[0].name"，而 JSON_EXTRACT 的第二个参数必须是字面路径表达式，不是字符串值。直接写 JSON_EXTRACT(data, JSON_SEARCH(...)) 会报错或返回 NULL。
正确做法是用 JSON_UNQUOTE 去掉外层引号，再拼接或替换。例如要找 id = "ccc" 对应的 type 值：
JSON_EXTRACT( data, REPLACE(JSON_UNQUOTE(JSON_SEARCH(data, 'one', 'ccc', NULL, '$.widges[*].id')), '.id', '.type') )
这个技巧依赖路径结构稳定——如果 .id 和 .type 不在同一层级，或中间有动态字段名，就会失效。更健壮的方式是改用 JSON_TABLE（见下一条）。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
JSON_SEARCH + JSON_TABLE 是更可靠的组合方案
当你要“根据某个键的值查另一个键”，单纯靠 JSON_SEARCH 拼路径容易出错，尤其面对数组嵌套、重复键、空值等情况。JSON_TABLE 把 JSON 数组展开成虚拟表，天然支持 WHERE 过滤和字段投影，语义清晰且可索引（配合生成列）。
例如从 data->'$.widges' 数组中找 id = "ccc" 的 type：
SELECT jt.type
FROM your_table,
JSON_TABLE(
data, '$.widges[*]'
COLUMNS (
id VARCHAR(50) PATH '$.id',
type VARCHAR(50) PATH '$.type'
)
) AS jt
WHERE jt.id = 'ccc';
注意：JSON_TABLE 要求 MySQL ≥ 8.0.4，且路径必须明确指向数组（[*]），不能是对象或标量。如果原 JSON 是对象而非数组，得先用 JSON_ARRAY 包一层，或重构数据结构。
容易被忽略的细节：大小写、空格和 NULL 处理
JSON_SEARCH 默认区分大小写，搜 'Admin' 找不到 'admin'。没有内置不区分大小写选项， workaround 是提前把目标字段转成小写再搜，比如：JSON_SEARCH(JSON_SET(data, '$.searchable', LOWER(JSON_EXTRACT(data, '$.role')))), 'one', 'admin')——但这需要修改原始数据或加生成列，成本高。
另一个坑是：若搜索路径下某个元素为 NULL，JSON_SEARCH 会跳过它，不报错也不提示；若整个路径不存在，返回 NULL，而不是空字符串，所以用 IFNULL 或 COALESCE 包一层更安全。
最常被忽视的其实是性能：在大表上对 JSON 字段反复调用 JSON_SEARCH 无法走索引，全表扫描不可避免。真要高频查询，应该把关键字段抽出来建生成列+索引，而不是依赖运行时解析。
