ThinkPHPJSON查询太复杂_ThinkPHPJSON字段检索技巧【操作】

ThinkPHP 的 JSON 字段查询，很多人一开始觉得“不就是写个 where 条件嘛”，结果一跑就翻车——明明语法看着没错，数据就是查不出来。问题往往出在四个环节上：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') —— 左边返回的是带引号的，右边是裸字符串，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 确认数据没问题，再谈查询技巧。