mysql 8.0多值索引仅对member of、json_contains、json_overlaps三类查询生效,需用cast(... as ... array)显式声明数组类型,且联合索引中最多含一个array键。

MySQL 8.0 的多值索引只对 MEMBER OF、JSON_CONTAINS、JSON_OVERLAPS 这三类查询真正生效,其他写法(比如 ->> + LIKE)哪怕看着像,也完全走不了索引。
必须用 CAST(… AS … ARRAY) 显式声明数组类型
多值索引不是直接建在 JSON 字段上的,而是依赖 CAST 把路径提取结果强制转成 SQL 类型数组,MySQL 才能据此生成虚拟列并建函数索引。漏掉这一步,索引建不成功或建了也无效。
-
CAST(tags AS CHAR(20) ARRAY)合法 ——tags是 JSON 数组,元素全为字符串且长度可控 -
CAST(data->'$.ids' AS UNSIGNED ARRAY)合法 —— 路径指向数组,元素可映射为整型 -
data->'$.ids'单独用会报错ERROR 3152 (HY000): Cannot create a functional index on a non-stored generated column -
CAST(data->'$.name' AS CHAR(10))不合法 ——$.name是标量(字符串),不是数组,CAST 会提示Invalid cast
哪些 WHERE 条件能真正命中多值索引
优化器只认死理:只有明确调用那三个函数,且参数格式严格匹配,才启用多值索引。EXPLAIN 看不到索引名,但 key 列非 NULL、rows 显著下降,就是生效了。
- ✅
WHERE 5 MEMBER OF(tags)—— 最简洁,查单个元素是否存在 - ✅
WHERE JSON_CONTAINS(tags, '[5, 8]')—— 查是否包含全部指定元素(AND 语义) - ✅
WHERE JSON_OVERLAPS(tags, CAST('[5, 9]' AS JSON))—— 查是否有交集(OR 语义) - ❌
WHERE tags->>'$[0]' = '5'—— 走全表扫描,路径取值 + 等值比较不触发多值索引 - ❌
WHERE JSON_CONTAINS(tags, '"5"')—— 第二个参数必须是 JSON 数组字面量或变量,不能是带引号的字符串
复合索引里多值部分只能有一个,且位置自由但受最左前缀约束
你可以把多值字段和其他普通列一起建联合索引,语法允许,但有硬性限制:一个索引中最多含一个 ARRAY 类型键部分;它在索引中的顺序不影响创建,但影响使用条件。
- ✅
CREATE INDEX idx_comp ON users (status, CAST(tags AS CHAR(20) ARRAY), created_at)—— 合法,status和tags都出现在 WHERE 中时能用上 - ✅
WHERE status = 'active' AND 3 MEMBER OF(tags)—— 满足最左前缀,能用索引 - ✅
WHERE 3 MEMBER OF(tags)—— 即使没status条件,也能用该索引(多值部分可独立触发) - ❌
CREATE INDEX idx_bad ON users (CAST(tags AS CHAR(20) ARRAY), CAST(roles AS CHAR(20) ARRAY))—— 直接报错,不允许多个 ARRAY 键
真正容易被忽略的是:每个 JSON 数组元素都会在索引中生成一条独立记录,[1,2,3] 会变成三条索引项;如果数组普遍很长,索引体积和维护成本会明显上升,而它又不支持 ORDER BY 或 GROUP BY —— 别指望靠它做排序加速。











