thinkphp json字段查询需满足mysql≥5.7、字段类型为json、正确使用->>去引号语法、json_contains传合法json字符串，并为高频查询建虚拟列+索引，否则全表扫描。
ThinkPHP 对 JSON 字段的查询不是“开箱即用”，直接写 where('data->status', 1) 很可能查不到数据——原因不是语法错，而是你没确认 MySQL 版本、字段类型、引号处理或索引支持。
确认 MySQL 版本和字段类型是前提
TP6 的 -> 语法底层依赖 MySQL 5.7+ 的 JSON 函数，且仅对类型为 JSON 的字段有效。字段是 VARCHAR 或 TEXT 时，-> 会报错或静默失效。
- 执行
SHOW COLUMNS FROM table_name LIKE 'data';，确认Type列显示的是json - 查 MySQL 版本：
SELECT VERSION();，必须 ≥ 5.7（推荐 8.0+） - 如果字段是
TEXT，别硬套->语法，改用whereRaw+JSON_EXTRACT，但要注意引号问题
查 JSON 对象里的某个键值，别漏掉 ->>
-> 返回带双引号的 JSON 字符串（如 "active"），直接跟 PHP 字符串比较会失败；->> 才返回去引号后的纯值（如 active），适合 =、LIKE、数值比较。
- 正确写法：
where('data->>status', 'active')（等价于JSON_UNQUOTE(JSON_EXTRACT(data, "$.status")) = "active"） - 数字比较也安全：
where('data->>score', '>', 90) - 模糊搜索字段值：
where('data->>name', 'like', '%张%')，不用手动加引号 - 错误写法：
where('data->status', 'active')→ 实际在比"active" = "active"？不，右边没引号，MySQL 当字符串字面量处理，不匹配
查 JSON 数组是否包含某元素，JSON_CONTAINS 要传合法 JSON 字符串
JSON_CONTAINS 第二个参数必须是完整、带引号的 JSON 值，不能是裸字符串。PHP 里拼错一个引号，查询就失效。
- 查
["php", "mysql"]是否含php：whereRaw('JSON_CONTAINS(tags, ?)', ['"php"']) - 变量来自用户输入：
$tag = json_encode($userInput, JSON_UNESCAPED_UNICODE); whereRaw('JSON_CONTAINS(tags, ?)', [$tag]) - 指定路径更安全（防嵌套冲突）：
whereRaw('JSON_CONTAINS(tags, ?, "$.skills")', ['"vue"']) - 别写
JSON_CONTAINS(tags, "php")—— 这是 SQL 字符串，不是 JSON，MySQL 直接报错
性能陷阱：没虚拟列 + 索引，再准的查询也是全表扫
哪怕你用对了 ->> 和 JSON_CONTAINS，只要没建虚拟列并加索引，MySQL 就没法走索引，EXPLAIN 显示 type: ALL 是常态。
- 高频查
data->>status？建虚拟列：ALTER TABLE posts ADD COLUMN status_text VARCHAR(20) AS (data->>'$.status') STORED; - 再加普通索引：
CREATE INDEX idx_status_text ON posts(status_text); - TP 查询改回简单写法：
where('status_text', 'active')，性能提升明显 - 别指望
->>表达式本身能被索引——MySQL 不支持函数索引（除非你用 8.0+ 的函数索引语法，但 TP 不原生适配）
最常被跳过的一步是验证 JSON 字段内容本身是否合法：写入时没用 json_encode()、NULL 值没处理、前端传了格式错误的 JSON——这些都会让后续所有查询失效。先确保 json_last_error() === JSON_ERROR_NONE，再谈查询技巧。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
