MySQL 5.7 中 JSON 字段不能直接建索引,必须创建 STORED 生成列并为其建普通索引;因 JSON 是二进制存储且优化器不支持路径表达式索引,VIRTUAL 列不可索引,查询须引用生成列名而非原 JSON 路径。

MySQL 5.7 中 JSON 字段本身不能建索引,必须先创建 STORED 类型的生成列(不是 VIRTUAL),再对该列建普通 B+ 树索引,否则 WHERE json_col->>"$.field" 永远全表扫描。
为什么不能直接对 JSON 字段建索引
MySQL 5.7 的优化器不支持将整个 JSON 值或其路径表达式(如 properties->>"$.email")作为索引键。执行 CREATE INDEX idx ON t (json_col) 会报错:JSON column 'json_col' cannot be used in key specification。这不是语法问题,是内核级限制——连前缀索引都不允许,更别说函数索引(那是 8.0.13 才支持的)。
必须用 STORED 生成列,不能用 VIRTUAL
VIRTUAL 列在查询时动态计算,MySQL 5.7 明确禁止对其建索引(官方文档有说明)。哪怕你写了 ADD INDEX ... ON (v_col),也会失败。只有 STORED 列才真正落盘、可索引。
解析 MySQL 8.0 的 DDL 脚本,并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景,导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理,每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
-
GENERATED ALWAYS AS (json_col->>"$.email") STORED是必须写法,STORED关键字不能省略 - 类型要匹配:如果 JSON 里 email 可能超长,
VARCHAR(255)就得调大,否则截断后查不到 - 路径表达式必须确定性:不能含
NOW()、RAND()等非确定函数,否则ALTER TABLE直接失败
建索引后查询必须引用生成列名
生成列建好并加了索引,查询时必须直接写 WHERE email = 'x@y.z',而不是再写 WHERE properties->>"$.request.email" = 'x@y.z'。后者仍会触发全表扫描,因为优化器无法自动重写为生成列引用。
- 确认是否走索引:用
EXPLAIN SELECT * FROM activity_log WHERE email = 'x@y.z',看到type: ref或range才算成功 - 注意字符串引号:用
->>(去引号提取)而非->(带双引号),否则生成列值多一对引号,导致等值匹配失效 - 若 JSON 路径嵌套深(如
$.data.user.profile.email),确保路径字符串完全一致,大小写和空格都敏感
数组字段(如 phone 数组)无法用常规生成列索引
对于 {"phone": ["157", "153"]} 这类数组,json_col->>"$.phone" 返回的是 ["157", "153"] 字符串,无法直接用于等值索引。想查“包含某号码”,只能靠 JSON_CONTAINS(json_col, '"157"', '$.phone'),但这个在 5.7 里依然无法走索引——它本质是运行时遍历解析,没有对应生成列可映射。
这是 MySQL 5.7 的硬限制,别试图用 JSON_EXTRACT + JSON_UNQUOTE 组合绕过;只要最终结果是非标量(比如数组或对象),就无法构造出可索引的 STORED 列。

















