MySQL JSON_OVERLAPS 怎样判断两个 JSON 是否有交集

在标签筛选、权限集合或配置比对中，我们经常只想知道两份 JSON 有没有“碰到同一个值”。MySQL 的 JSON_OVERLAPS() 正好用于这个判断：数组共享至少一个元素时返回 1，对象共享完整的键值对时返回 1，两个标量相等时也返回 1。它不是“只要键名相同就算交集”，也不会把数字和字符串自动转换。

官方文档地址：https://dev.mysql.com/doc/refman/8.4/en/json-search-functions.html

判断两个 JSON 是否有交集，直接写 JSON_OVERLAPS(json_doc1, json_doc2)。先确认两边的 JSON 形态，再按数组元素、对象完整键值对或标量相等来解释返回值；任一参数是 SQL NULL 时，结果不是 0，而是 NULL。

先把 JSON_OVERLAPS 的“交集”定义说清楚

最容易出错的地方是把 JSON 的交集想成关系型表的“相同字段”。官方规则更具体：数组看元素是否至少有一个相同，对象看是否至少有一个完整的键值对相同，两个标量则做简单相等判断。

用数组和对象案例定位误判

先从数组开始。下面两组数组分别共享 5 和 7，所以即便其它数字完全不同，也都返回 1。第三组没有共同元素，返回 0。

-- 数组只要共享一个完整元素，就算有交集
SELECT JSON_OVERLAPS('[1,3,5,7]', '[2,5,7]') AS has_overlap;
-- 结果：1

-- 没有共同元素时返回 0
SELECT JSON_OVERLAPS('[1,3,5,7]', '[2,6,8]') AS has_overlap;
-- 结果：0

对象要注意“键和值必须一起相同”。d:10 与 d:20 不是同一个键值对，不能因为键名都叫 d 就判定为有交集。

-- d:10 在两边完整相同，因此返回 1
SELECT JSON_OVERLAPS(
  '{"a":1,"b":10,"d":10}',
  '{"c":1,"e":10,"f":1,"d":10}'
) AS has_overlap;
-- 结果：1

-- 只有 a、d 的键名相同，但对应的值都不同，因此返回 0
SELECT JSON_OVERLAPS(
  '{"a":1,"b":10,"d":10}',
  '{"a":5,"e":10,"f":1,"d":20}'
) AS has_overlap;
-- 结果：0

-- 嵌套数组不会做“部分匹配”；[1,2] 与 1 不是同一个数组元素
SELECT JSON_OVERLAPS(
  '[[1,2],[3,4],5]',
  '[1,[2,3],[4,5]]'
) AS has_overlap;
-- 结果：0

这组结果说明，排查时应该先看 JSON 的层级和元素类型，再看值是否完整相同。把对象拆成“只比较键名”的自定义逻辑，会得到与函数语义不同的结果。

处理标量、NULL 与类型边界

两个标量作为参数时，函数就是相等比较。标量和数组比较时，MySQL 会把标量按数组中的一个元素来判断；但这不代表数字和字符串可以互相转换。

-- 两个数字标量相等
SELECT JSON_OVERLAPS('5', '5') AS same_scalar;
-- 结果：1

-- 数字标量 6 可与数组中的数字元素 6 匹配
SELECT JSON_OVERLAPS('[4,5,6,7]', '6') AS same_element;
-- 结果：1

-- 数字 6 与字符串 "6" 类型不同，不发生隐式转换
SELECT JSON_OVERLAPS('[4,5,6,7]', '"6"') AS same_element;
-- 结果：0

-- SQL NULL 需要单独识别：结果是 NULL，不是没有交集的 0
SELECT JSON_OVERLAPS(NULL, '[1,2,3]') AS overlap_result;
-- 结果：NULL

如果业务字段可能为空，建议在查询结果层明确处理三值逻辑。例如把“只有明确有交集才算命中”写成 COALESCE(JSON_OVERLAPS(tags, :wanted), 0) = 1；这里的 COALESCE 是业务语义选择，不是 JSON_OVERLAPS 自动完成的转换。

把判断接入查询条件

在表查询中，函数可以直接放进 WHERE。例如一张商品表的 labels 列保存 JSON 数组，要找出与筛选集合至少共享一个标签的记录：

-- labels 保存 JSON 数组；只筛选至少命中一个标签的商品
SELECT id, name
FROM product
WHERE JSON_OVERLAPS(labels, '["mysql","json"]') = 1;

-- 空值不应被当成命中；用 COALESCE 将 NULL 明确按未命中处理
SELECT id, name
FROM product
WHERE COALESCE(JSON_OVERLAPS(labels, '["mysql","json"]'), 0) = 1;

MySQL 8.4 手册还说明，InnoDB 表上对 JSON 列使用 JSON_OVERLAPS() 作为 WHERE 条件时，可以结合多值索引进行优化。是否值得建立索引，要结合数据分布和执行计划判断，不要因为函数可用就直接添加索引。

用 JSON_CONTAINS 做最后对照

JSON_OVERLAPS() 和 JSON_CONTAINS() 的关键区别可以记成“OR 对 AND”。前者只要找到一个共同元素或键值对就返回 1；后者要求被查询的候选 JSON 全部包含在目标 JSON 中。

-- 只要 5 或 7 中有一个命中，就返回 1
SELECT JSON_OVERLAPS('[1,3,5,7]', '[2,5,9]') AS any_match;

-- 候选数组中的每个元素都要在目标数组中，才返回 1
SELECT JSON_CONTAINS('[1,3,5,7]', '[5,7]') AS all_match;

-- 这里 9 不在目标数组中，因此不是“有一个命中”就算成功
SELECT JSON_CONTAINS('[1,3,5,7]', '[5,9]') AS all_match;

最终选择标准很简单：筛选标签、权限或特征时只要“至少共享一个”，使用 JSON_OVERLAPS()；需要确认一组要求全部包含时，才考虑 JSON_CONTAINS()。如果你还要区分 SQL NULL、空数组和没有共同元素，先把这三种输入分别列为测试样例。

常见问题

对象只要有相同键名就会返回 1 吗？

不会。对象必须存在至少一个完整相同的键值对；键相同但值不同不算交集。

JSON_OVERLAPS 会把 6 和 "6" 当成同一个值吗？

不会。函数不做这种类型转换，数字和字符串需要按不同 JSON 类型处理。

两个空数组会返回什么？

它们没有共同数组元素，因此应按没有交集理解；实际查询中仍建议把空数组与 SQL NULL 分开测试，因为 NULL 会传播为 NULL。

小结：JSON_OVERLAPS() 解决的是“至少共享一项”的 JSON 比较。数组看元素，对象看完整键值对，标量看相等；NULL 和类型差异是最需要在查询条件中明确处理的两个边界。