mysql 5.7.8起原生支持json类型，自动校验格式、二进制优化存储、支持->/->>操作符及json函数；需确保phpenv中mysql≥5.7.8、字符集utf8mb4、避免默认值错误，并正确使用预处理与json_decode。
phpEnv 本身不决定 MySQL 是否支持 JSON 类型，它只是 Windows 下的 PHP + MySQL 集成环境管理工具。只要它搭载的 MySQL 版本 ≥ 5.7.8，JSON 支持就默认开启——你不需要额外“配置 phpEnv”来启用 JSON 功能，但必须确认并正确使用底层 MySQL 实例。
确认 phpEnv 中 MySQL 版本是否 ≥ 5.7.8
这是所有操作的前提。低版本（如 5.6 或 MariaDB 默认旧版）根本不识别 JSON 类型，建表会报错 ERROR 1064。
- 打开 phpEnv 控制面板 → 查看“MySQL”服务右侧显示的版本号（例如
MySQL 8.0.33或MySQL 5.7.40） - 若版本低于 5.7.8：必须更换 phpEnv 内置的 MySQL 包，或手动替换
mysql目录为兼容版本（注意备份原数据目录data/） - 命令行验证：
mysql --version或连接后执行SELECT VERSION();
创建含 JSON 字段的表时避免常见语法错误
即使 MySQL 版本达标，建表语句写错也会导致失败。重点不是“怎么配”，而是“怎么写对”。
-
JSON列不能有默认值（MySQL 8.0.13+ 才支持DEFAULT NULL），所以不要写data JSON DEFAULT '{}'—— 会报ERROR 1101 - 字符集必须是
utf8mb4（而非utf8），否则插入含 emoji 或中文的 JSON 可能乱码或截断 - 正确示例：
CREATE TABLE users (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50), config JSON, INDEX idx_city ((CAST(config->>'$.city' AS CHAR(20))))); - 注意：括号里的虚拟列索引语法仅在 MySQL 5.7.9+ 支持；若用 phpEnv 搭载的是 5.7.8，需改用生成列方式或放弃索引
PHP 中读写 JSON 字段必须绕过字符串拼接
很多人在 phpEnv 环境里查不到数据，不是 MySQL 不支持，而是 PHP 层把 JSON 当普通字符串处理了，丢失了结构和类型语义。
- 写入时别用
"INSERT INTO t VALUES ('{\"a\":1}')"这种硬拼——既不安全，又跳过 MySQL 的 JSON 校验。应改用JSON_SET()或预处理绑定： $stmt = $pdo->prepare("INSERT INTO users (config) VALUES (JSON_SET('{}', '$.theme', ?))"); $stmt->execute(['dark']);- 查询时慎用
->和->>：前者返回 JSON 文本（带引号），后者返回去引号标量值。比如config->>'$.price'得到99（数字），而config->'$.price'得到"99"（字符串），WHERE 条件容易失配 - 从结果中取 JSON 字段后，必须用
json_decode($row['config'], true)，且第二个参数true不能省——否则得到对象，foreach或数组访问会出错
phpEnv 下调试 JSON 查询失败最该先看的三处
很多问题其实和 phpEnv 无关，但排查路径被环境干扰。直接盯住这三项，省掉 80% 的无谓折腾：
- MySQL 错误日志位置通常在 phpEnv 安装目录下的
mysql/data/你的主机名.err，建表或插入失败时这里一定有明确提示，比如Invalid JSON text或Cannot create a JSON value from a string with CHARACTER SET 'latin1' - PHP 连接 MySQL 时未指定
charset=utf8mb4，会导致json_encode()输出的中文在入库时变成???，后续JSON_EXTRACT()查不到 - phpEnv 自带的 phpMyAdmin 版本太老（如 4.x），不识别
->>语法，执行 SQL 会报错；此时应改用命令行mysql -u root -p或升级 phpMyAdmin
真正卡住人的地方，往往不是 JSON 功能本身，而是 phpEnv 把多个组件版本耦合在一起，让你分不清问题是出在 MySQL 解析、PHP 编码、还是客户端工具兼容性上。每次操作前，先用 SELECT JSON_VALID('{\"a\":1}'); 和 SELECT VERSION(); 交叉验证，比反复重装 phpEnv 有效得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
