MySQL MEMBER OF 怎样判断 JSON 数组是否包含值

我第一次把 JSON 数组成员条件写进 MySQL 查询时，最容易误判的是“看起来一样”的值：数字 17 和字符串 "17" 并不等价。这个场景用 MEMBER OF() 很直接，但前提是把待判断值、JSON 数组和 JSON 类型分清楚。

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

写法就是 value MEMBER OF(json_array)：返回 1 说明值是数组元素，返回 0 说明不是；任意一侧为 NULL 时返回 NULL。字符串和数字不会自动互转。

先确认 MEMBER OF() 的左右两侧

把要查找的值放在左边，把 JSON 数组放在右边。下面的数组是一个 JSON 文本，数字 17 确实是其中的一个元素。

-- 左侧是待判断值，右侧是 JSON 数组
SELECT 17 MEMBER OF('[23, "abc", 17, "ab", 10]') AS is_member;

-- 只判断完整元素，不把 7 当成 17 的部分匹配
SELECT 7 MEMBER OF('[23, "abc", 17, "ab", 10]') AS is_member;

第一条返回 1，第二条返回 0。这里的关键不是“文本里有没有这几个字符”，而是数组中是否存在一个可比较、完全匹配的元素。这个判断适合做一个清晰的布尔条件，也可以直接放进 WHERE。

分别处理数字和字符串

我排查“明明有值却查不到”时，通常先看 JSON 数组里保存的是数字还是字符串。MySQL 的 MEMBER OF() 不会在两者之间做字符串转换。

-- 数字只匹配数字元素，字符串只匹配字符串元素
SELECT
    17 MEMBER OF('[23, "abc", "17", "ab", 10]') AS number_match,
    '17' MEMBER OF('[23, "abc", 17, "ab", 10]') AS string_match;

-- 完整字符串可以命中同类型的数组元素
SELECT 'ab' MEMBER OF('[23, "abc", 17, "ab", 10]') AS text_match;

前两列都应为 0，最后一列为 1。应用层写入 JSON 时要先约定字段类型；如果业务 ID 有时写成数字、有时写成带引号的文本，查询条件就会出现看似随机的结果。不要只改 SQL 里的引号来“试到能返回 1”，先确认存储约定。

处理数组、对象和 NULL 边界

标量值可以直接参与判断，但数组或对象本身是 JSON 文档，需要显式构造成 JSON 类型。否则，左侧的数组可能被当成普通字符串，而不是一个数组元素。

-- 用 JSON_ARRAY 构造左侧 JSON 数组，再判断它是否是嵌套数组元素
SELECT JSON_ARRAY(4, 5) MEMBER OF('[[3, 4], [4, 5]]') AS array_match;

-- 用 JSON_OBJECT 构造对象，避免把对象误写成普通字符串
SELECT JSON_OBJECT('role', 'admin')
       MEMBER OF(JSON_ARRAY(JSON_OBJECT('role', 'admin'))) AS object_match;

-- NULL 不等于“不在数组中”，而是得到 NULL
SELECT NULL MEMBER OF('[1, 2, 3]') AS unknown_result;

数组和对象的例子都表达“完整 JSON 值是数组元素”，不是把内部字段拆开比较。任意一侧为 NULL 时，结果也是 NULL，所以在报表或过滤条件中不要把 NULL 直接当作 0；需要业务上的“未命中”时，再用 COALESCE(..., 0) 明确转换。

决定何时换 JSON_CONTAINS

MEMBER OF() 解决的是“这个值是不是数组的一个完整元素”。如果问题变成“某个 JSON 文档是否包含指定结构”，或者需要指定 JSON 路径，就应该看 JSON_CONTAINS()。两者都返回布尔式结果，但问题边界不同。

-- MEMBER OF：判断一个标量是否是数组元素
SELECT 17 MEMBER OF('[10, 17, 20]') AS member_result;

-- JSON_CONTAINS：判断对象是否包含指定键值结构
SELECT JSON_CONTAINS(
    '{"user": {"role": "admin"}}',
    '{"role": "admin"}',
    '$.user'
) AS document_result;

我的选择习惯是：数组成员条件优先写 MEMBER OF()，因为意图更窄、更容易读；需要路径或对象包含关系时再用 JSON_CONTAINS()。如果条件落在 InnoDB 的 JSON 列上，还要结合数据规模和索引设计单独评估，不能仅凭函数名字判断性能。

常见问题

为什么 17 MEMBER OF('["17"]') 返回 0？
因为左侧是数字，数组元素是字符串；MySQL 不在两种字符串类型之间自动转换。

为什么结果是 NULL 而不是 0？
检查左侧值或右侧 JSON 数组是否为 NULL。需要把未知统一按未命中处理时，显式使用 COALESCE。

什么时候不该继续套 MEMBER OF()？
当你要按路径判断对象包含关系、检查多个键值或匹配更复杂的 JSON 文档时，改用 JSON_CONTAINS() 更清晰。