如何在ThinkPHP中处理JSON字段的模糊搜索_JSON函数与whereRaw应用-ThinkPHP-PHP中文网

MySQL 5.7+才原生支持JSON函数，低版本需用LIKE或JSON_UNQUOTE配合JSON_EXTRACT；查JSON数组须传合法JSON字符串如'"thinkphp"'；高频查询必须建虚拟列+索引，否则全表扫描。

如何在thinkphp中处理json字段的模糊搜索_json函数与whereraw应用

ThinkPHP里用`whereRaw`查JSON字段要小心MySQL版本

MySQL 5.7+ 才原生支持JSON_CONTAINS、JSON_EXTRACT这些函数，低版本只能靠LIKE硬匹配，结果不准还慢。TP6 默认不校验MySQL版本，你写了JSON_CONTAINS，线上一跑就报FUNCTION JSON_CONTAINS does not exist。

实操建议：

上线前先确认SELECT VERSION()结果 ≥ 5.7
如果必须兼容5.6，改用whereRaw('content LIKE ?', ["%{$keyword}%"])，但得确保content字段不是纯JSON对象嵌套太深，否则会误匹配
TP6.1+ 可以用json_unquote(json_extract(`content`, '$.title'))把路径值转成字符串再模糊查，比LIKE准一点

`JSON_EXTRACT`返回带引号的字符串，直接`LIKE`会失败

比如JSON_EXTRACT(content, '$.name')返回的是"张三"（带双引号），你写whereRaw("JSON_EXTRACT(content, '$.name') LIKE '%张%'"，实际查的是"张三"是否含“张”，当然不中——因为引号是字面量的一部分。

实操建议：

统一用JSON_UNQUOTE(JSON_EXTRACT(content, '$.name'))去掉引号再比较
或者改用JSON_CONTAINS(content, '"张三"')，注意第二个参数必须是合法JSON字符串，所以中文要加双引号、特殊字符得addslashes
别在whereRaw里拼接用户输入，一定要用参数绑定：whereRaw('JSON_UNQUOTE(JSON_EXTRACT(content, "$.name")) LIKE ?', ["%{$keyword}%"])

TP6模型里用`whereRaw`查JSON数组字段的某个元素

比如tags是JSON数组["php", "thinkphp", "mysql"]，你想查包含thinkphp的记录。不能直接JSON_CONTAINS(tags, 'thinkphp')，它只认完整JSON值，得传"thinkphp"。

实操建议：

正确写法：whereRaw('JSON_CONTAINS(tags, ?)', ['"thinkphp"']) —— 注意引号是JSON语法要求，不是PHP字符串
如果关键词来自变量，用json_encode($tag, JSON_UNESCAPED_UNICODE)生成合法JSON字符串再传入
查多个标签同时存在？JSON_CONTAINS(tags, \'["php", "mysql"]\')，但注意顺序无关，且必须是子集关系

性能隐患：JSON字段没索引，`whereRaw`一查全表扫

哪怕你用了JSON_EXTRACT，只要没建虚拟列+索引，MySQL照样没法走索引。TP里写得再优雅，执行计划里还是type: ALL。

实操建议：

高频查询的JSON字段，必须加虚拟列：ALTER TABLE posts ADD COLUMN title_text VARCHAR(100) AS (JSON_UNQUOTE(JSON_EXTRACT(content, '$.title'))) STORED;
然后给虚拟列建索引：CREATE INDEX idx_title_text ON posts(title_text);
TP里就可以安全地写where('title_text', 'like', "%{$k}%")，不用whereRaw也快

虚拟列名和索引名别用保留字，比如content或json，容易出错。真正麻烦的从来不是怎么写，而是忘了加索引之后，数据量一过十万，接口就开始超时。