MySQL 8.0.17+多值索引必须用CAST(... AS TYPE ARRAY)语法创建,依赖双括号、大小写敏感的ARRAY、合法类型(如UNSIGNED/DATE),仅MEMBER OF/JSON_CONTAINS/JSON_OVERLAPS可触发索引。

MySQL 8.0.17+ 原生支持多值索引,但不是开个配置就能用——它依赖明确的语法、类型约束和查询方式。不按规范写,CAST会报错,索引不会生效,EXPLAIN里也看不到走索引。
多值索引必须用 CAST(… AS TYPE ARRAY) 语法创建
这是硬性要求,漏掉任何一部分都会失败。常见错误包括:少一层括号、类型写错、ARRAY 写成 Array 或 array(大小写敏感)、JSON 路径写错。
-
ALTERTABLE users_with_tags ADD INDEX idx_tags ((CAST(tags AS UNSIGNED ARRAY)) )✅ 正确:外层双括号 +UNSIGNED+ 大写ARRAY -
ADD INDEX idx_tags (CAST(tags AS UNSIGNED ARRAY))❌ 报错:缺最外层括号 -
ADD INDEX idx_tags ((CAST(tags AS CHAR ARRAY))❌ 不支持:CHAR类型在多值索引中不可用(截至 8.0.33) -
ADD INDEX idx_tags ((CAST(tags->'$.ids' AS UNSIGNED ARRAY))✅ 可用:支持 JSON 路径提取,前提是tags是合法 JSON 字段且该路径下是数组
只支持特定类型转换,且数组元素必须同构
多值索引底层把 JSON 数组映射为 SQL 数组,因此所有元素必须能统一转为目标类型。混入 null、字符串或不同数字类型(如 "1" 和 2)会导致 CAST 失败或索引条目缺失。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 允许:
[1, 5, 8]→CAST(... AS UNSIGNED ARRAY) - 允许:
["2023-01-01", "2024-02-02"]→CAST(... AS DATE ARRAY) - 拒绝:
[1, "tag_5", null]→ 转UNSIGNED时部分值无法转换,整行该字段不生成索引记录 - 拒绝:
[1, 3.14]→UNSIGNED无法容纳浮点数,CAST 行为未定义,建议提前清洗数据
只有 MEMBER OF / JSON_CONTAINS / JSON_OVERLAPS 能走多值索引
别指望 JSON_EXTRACT 或 -> 操作符触发索引。MySQL 优化器只识别这三种语义明确的“数组成员判断”操作。
- ✅ 走索引:
WHERE 5 MEMBER OF(tags) - ✅ 走索引:
WHERE JSON_CONTAINS(tags, '[5, 8]')(需全部匹配) - ✅ 走索引:
WHERE JSON_OVERLAPS(tags, '[5, 8]')(任一匹配) - ❌ 不走索引:
WHERE tags->'$[0]' = 5(取第一个元素比较) - ❌ 不走索引:
WHERE JSON_LENGTH(tags) > 2(数组长度判断)
唯一多值索引有隐含约束,插入时容易被忽略
加 UNIQUE 前必须确保:同一数组内无重复值,且不同行之间不能出现“交叉重复”——即任意两行的数组如果有交集,就违反唯一性。
- 假设已建:
ADD UNIQUE INDEX idx_uq ((CAST(tags AS UNSIGNED ARRAY)) ) - 允许插入:
{"tags": [1, 2]}和{"tags": [3, 4]} - 拒绝插入:
{"tags": [1, 5]}(因为已有行含1)→ 报错Duplicate entry '1' for key 'idx_uq' - 注意:这个“唯一”是按数组元素粒度去重,不是按整条 JSON 文本去重
真正难调试的是跨行冲突:你查单条数据看不出问题,但批量导入或并发写入时,唯一约束才突然爆发。上线前务必用真实分布数据压测索引行为。

















