Laravel中查询JSON字段需确认数据库支持、字段类型及语法正确性：MySQL≥5.7或PostgreSQL≥9.4且profile字段为json类型，再用->路径语法或whereJsonContains等方法精准匹配。
当你在 Laravel 项目中需要从 users 表的 profile JSON 字段里查出“住在北京市海淀区且年龄大于30岁的用户”，却只得到空结果，问题往往不出在数据本身，而在于路径写法、数据库类型限制或查询方法误用——MySQL 5.7+ 才支持原生 JSON 路径语法，SQLite 或旧版 MySQL 会静默失败。
确认字段类型与数据库支持
第一步：登录数据库执行 SHOW COLUMNS FROM users LIKE 'profile';，观察 Type 列是否为 【json】；若显示为 text 或 varchar，则后续所有 -> 路径查询都会返回空，Laravel 不报错但不生效。
第二步：运行 SELECT VERSION();，确认 MySQL 版本 ≥ 5.7；PostgreSQL 用户需确保版本 ≥ 9.4。低于此版本必须改用 whereJsonContains 或 PHP 层过滤。
第三步：在模型中检查 $casts 是否已声明，例如 protected $casts = ['profile' => 'array']; —— 这一步不影响查询语法，但影响取值后自动解码，漏写会导致 profile->age 取出来是字符串而非数字。
基础嵌套字段等值查询
方法一：直接使用 -> 路径语法（仅限 MySQL 5.7+/PostgreSQL）
在 User 模型中执行：User::where('profile->address->district', 'Haidian')->get();
这行代码会被 Laravel 编译为 MySQL 的 JSON_EXTRACT(profile, '$.address.district')，注意路径中不能有空格、单引号，且 district 必须是字符串字面量——如果存的是数字 100086，就得写 User::where('profile->address->code', 100086)->get();
方法二：用 DB::raw 避开 ORM 封装（兼容性更强）
DB::table('users')->whereRaw("JSON_EXTRACT(profile, '$.address.district') = ?", ['Haidian'])->get();
⚠️ 注意：这里必须用 ? 占位符绑定值，直接拼字符串会引发 SQL 注入；且 JSON_EXTRACT 返回的是带引号的字符串（如 "Haidian"），所以等号右边也要传字符串，不能传整数。
嵌套数组中匹配多个条件
第一步：明确你要查的是“数组中某个元素满足条件”，还是“对象中某个键对应值满足条件”——前者必须用 whereJsonContains，后者才可用 -> 语法。
第二步：假设 profile->tags 是 JSON 数组 ["vip", "premium"]，要找同时含 vip 和 premium 的用户：
User::whereJsonContains('profile->tags', 'vip')->whereJsonContains('profile->tags', 'premium')->get();
第三步：如果 profile->roles 是嵌套对象数组 [{"name": "admin", "level": 5}, {"name": "user", "level": 1}]，要找 role 名为 admin 且 level 大于 3 的记录：
DB::table('users')->whereRaw("JSON_CONTAINS(profile, ?)", ['{"name": "admin", "level": 5}'])->get();
这句实际查的是整个对象是否作为数组元素存在，不是模糊匹配；level 值必须完全一致，不能写 > 3。
混合条件：路径查询 + 数组包含判断
方法一：用闭包组合不同查询逻辑
User::where(function ($query) {
$query->where('profile->address->city', 'Beijing')
->whereJsonContains('profile->tags', 'vip');
})->get();
方法二：用 orWhere 实现“城市是北京 或 标签含 vip”
User::where(function ($query) {
$query->where('profile->address->city', 'Beijing')
->orWhereJsonContains('profile->tags', 'vip');
})->get();
注意：闭包内必须用 andWhere 或 orWhere 显式声明逻辑关系，否则外层 where 会把两个条件当 AND 处理，无法实现 OR 语义。
绕过限制：PHP 层解析后过滤（仅限小数据量）
当数据库不支持 JSON 函数，或字段类型是 TEXT 时，只能先取出再处理：
$users = User::select('id', 'profile')->get()->filter(function ($user) {
$profile = json_decode($user->profile, true) ?: [];
return ($profile['address']['district'] ?? '') === 'Haidian'
&& ($profile['age'] ?? 0) > 30;
});
这一步会把全表数据加载进内存，【千万级数据下禁止使用】；仅适用于后台管理页查几十条记录的场景。
