MySQL 5.7+才原生支持JSON函数，低版本需用LIKE或JSON_UNQUOTE配合JSON_EXTRACT；查JSON数组须传合法JSON字符串如'"thinkphp"'；高频查询必须建虚拟列+索引，否则全表扫描。
ThinkPHP里用whereRaw查JSON字段要小心MySQL版本
MySQL 5.7+ 才原生支持JSON_CONTAINS、JSON_EXTRACT这些函数，低版本只能靠LIKE硬匹配，结果不准还慢。TP6 默认不校验MySQL版本，你写了JSON_CONTAINS，线上一跑就报FUNCTION JSON_CONTAINS does not exist。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上线前先确认
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 '%张%'"，实际查的是"张三"是否含“张”，当然不中——因为引号是字面量的一部分。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一用
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"。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
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。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 高频查询的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，容易出错。真正麻烦的从来不是怎么写，而是忘了加索引之后，数据量一过十万，接口就开始超时。
