JSON_CONTAINS查不到数据需确认字段为JSON类型、第二个参数是合法JSON值（如'"admin"'）、嵌套结构需指定路径（如'$.roles'）、数字/布尔值/NULL须严格匹配类型，且该函数无法使用索引，大数据量时应建生成列索引优化。
JSON_CONTAINS查不到数据？先确认字段类型和JSON格式
MySQL的JSON_CONTAINS只对JSON类型字段生效，如果字段是VARCHAR或TEXT，即使存的是合法JSON字符串，函数也会始终返回0（即“不包含”）。另外，传入的第二个参数必须是合法JSON值——比如查字符串得写'"admin"'，而不是'admin'。
- 检查字段类型：
DESCRIBE users;确认目标列类型为json - 验证JSON合法性：
SELECT JSON_VALID(role);返回1才可信 - 字符串匹配必须加双引号并转义：要查
role里是否含"admin"，第二个参数得是'"admin"'，不是'admin'
JSON_CONTAINS路径参数怎么写才匹配到嵌套数组里的值？
当JSON字段里是数组（如["user","admin"]），直接用JSON_CONTAINS(role, '"admin"')就能命中；但如果数组嵌在对象里（如{"roles": ["user","admin"]}），就必须指定路径，否则函数只查顶层值，不会自动递归。
- 查顶层数组：
JSON_CONTAINS(roles, '"admin"')——roles列本身存的就是数组 - 查嵌套字段：
JSON_CONTAINS(profile, '"admin"', '$.roles')—— 第三个参数是JSON路径表达式 - 路径必须精确：写
'$.roles[0]'只会查第一个元素，写'$.roles'才会遍历整个数组
为什么JSON_CONTAINS对数字或布尔值总返回false？
JSON_CONTAINS做的是**JSON值语义比较**，不是字符串模糊匹配。传入的第二个参数必须和目标值类型、大小写、甚至null状态完全一致。比如123和"123"不相等，true和"true"也不等。
- 查数字：
JSON_CONTAINS(settings, '123')—— 注意没引号，是数字字面量 - 查布尔值：
JSON_CONTAINS(flags, 'true')—— 小写true，无引号 - 查
null：JSON_CONTAINS(data, 'null')—— 同样无引号，且目标字段对应位置真得是null，不是字符串"null"
性能注意：JSON_CONTAINS无法走索引，大数据量时怎么办？
JSON_CONTAINS本质是全表解析JSON内容，哪怕字段有JSON类型约束，它也无法利用B-tree索引加速。单表几万行可能就明显变慢，尤其路径较深或数组很长时。
- 高频查询字段建议拆成独立列，比如把
roles数组展开为关联表或用SET类型 - 若必须用JSON，可配合生成列+索引：
ALTER TABLE users ADD COLUMN role_admin TINYINT AS (JSON_CONTAINS(roles, '"admin"')) STORED，再给role_admin建索引 - 避免在
WHERE里多次调用JSON_CONTAINS，能合并逻辑尽量合并
真正麻烦的不是语法写错，而是误以为它能像普通字段一样高效——一旦数据量上来，没索引的JSON查询会突然卡住，而且不容易从慢日志里一眼识别出来。
