mysql 5.7.8+ 默认启用 json 类型支持,无需安装插件;确认版本 ≥ 5.7.8 后可直接建表使用 json 列,插入非法 json 会报错,varchar 无法替代其校验、函数及索引能力。

MySQL 5.7.8+ 默认已启用 JSON 类型支持,无需额外安装或插件——只要确认版本 ≥ 5.7.8,建表时直接用 JSON 类型即可生效。
确认 MySQL 版本和 JSON 支持状态
执行 SELECT VERSION(); 确保返回结果是 5.7.8 或更高;低于该版本(如 5.7.7)可能仅在 Labs 版本中提供,生产环境不建议使用。
验证 JSON 类型是否可用:
CREATE TABLE t_test (j JSON);
若报错 ERROR 1064 或提示未知类型,说明版本不达标或服务器编译时禁用了 JSON 支持(极少见,但某些定制版 MariaDB 或阉割版 MySQL 可能如此)。
- 检查是否误连到旧实例(比如本地开发环境多个 MySQL 并存)
-
SHOW VARIABLES LIKE 'version%';查看实际连接的 server 版本 - 避免使用
TEXT+ 手动校验的“伪 JSON”方案——它绕过了自动解析、索引、函数优化等核心优势
建表时直接定义 JSON 列的写法
语法和其他列类型完全一致,JSON 是一等数据类型,不是别名或扩展:
CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50), profile JSON );
关键点:
-
profile列可为NULL,但插入非 NULL 值时必须是合法 JSON 文本(如'{"city":"Beijing"}'),否则报错ERROR 3140 (22032) - 不能设默认值为字符串字面量(如
DEFAULT '{"active":true}'),会报错;如需默认空对象,可用DEFAULT (JSON_OBJECT())(MySQL 8.0.13+),5.7 中只能靠应用层或触发器补全 - 不支持
JSON类型字段做主键、外键或唯一约束(因内部是二进制格式,无法直接比较)
插入 JSON 数据的三种可靠方式
直接写字符串、用函数构造、或从其他列拼接——但都必须通过 MySQL 解析器验证:
- 字符串字面量(最常用):
INSERT INTO users (name, profile) VALUES ('Alice', '{"age":30,"tags":["dev","mysql"]}'); -
JSON_OBJECT()构造对象:INSERT INTO users (name, profile) VALUES ('Bob', JSON_OBJECT('role', 'admin', 'score', 95)); -
JSON_ARRAY()构造数组:INSERT INTO users (name, profile) VALUES ('Carol', JSON_ARRAY(1, 2, 'test'));
注意:JSON_OBJECT() 和 JSON_ARRAY() 在 5.7.13+ 才支持任意表达式作为值(如子查询),早期 5.7.x 版本只接受常量或列名;传入 NULL 会生成 JSON null 值,不是字符串 "null"。
为什么不能用 VARCHAR 存 JSON 字符串代替?
看似一样,实则丢失关键能力:
- 插入
'{ "name": "Tom", "age": }'这种语法错误 JSON,VARCHAR会静默存入,JSON列立刻报错Invalid JSON text -
->操作符、JSON_EXTRACT()等函数只对JSON类型列有效,对VARCHAR返回NULL或触发隐式转换(慢且不可靠) - 后续想加索引时,
VARCHAR上无法创建「多值索引」或基于JSON_EXTRACT的生成列索引(5.7 中唯一高效查 JSON 字段的方式)
真正需要灵活 schema 时,JSON 类型不是权宜之计,而是明确的设计选择;但别把它当万能筐——深度嵌套、高频更新单个字段、或需要事务级原子更新多个路径时,关系型拆表仍是更稳的选择。











