Laravel7+模型scope中whereJsonContains查JSON字段失效问题

你之前的代码不生效核心是三个问题：

• amenities字段存的是键值对结构的JSON对象，根节点值全是数组类型，Laravel自带的whereJsonContains默认在JSON根层级匹配值，直接传ID当然匹配不到。
• 闭包传参位置写错，orWhereJsonContains第一个参数必须传字段名，不能直接传闭包，语法本身就不符合框架要求。
• 你测试写的whereJsonContains('amenities',['3'])，生成的SQL是找根节点为数组、且包含元素3的记录，和你实际存储的对象结构完全不匹配，自然查不出数据。

模型Scope写法 #

直接在Villa模型里写如下方法，兼容「选中ID是顶级设施」和「选中ID是子设施」两种场景，默认匹配规则为包含任意一个选中设施即符合要求（复选框筛选的常规逻辑）：

public function scopeFilterAmenity($query, array $filterAmenityIds)
{
    // 嵌套where包裹所有OR条件，避免和其他筛选条件出现SQL逻辑优先级冲突
    return $query->where(function ($q) use ($filterAmenityIds) {
        foreach ($filterAmenityIds as $id) {
            // 场景1：ID是顶级设施，即作为JSON的key存在（对应存储格式里"3":[]这类无子女的顶级项）
            // MySQL中数字类型的JSON key，路径需要用双引号包裹才能正确解析
            $q->orWhereRaw('JSON_CONTAINS_PATH(amenities, "one", ?)', ['$."' . $id . '"']);
            // 场景2：ID是子设施，即存在于任意顶级key对应的子数组中（对应"1":["24","30"]里24、30这类子项）
            $q->orWhereRaw('JSON_SEARCH(amenities, "one", ?) IS NOT NULL', [$id]);
        }
    });
}

控制器调整 #

控制器端加一层参数过滤，拦截非法值避免无效查询：

if ($request->has('am') && is_array($request->am)) {
    // 过滤非数字值，统一转成整数格式
    $amenityIds = collect($request->am)
        ->filter(fn($id) => is_numeric($id))
        ->map(fn($id) => (int)$id)
        ->toArray();
    if (!empty($amenityIds)) {
        $villas = $villas->filterAmenity($amenityIds);
    }
}

• 如果你的筛选逻辑是必须同时匹配所有选中的设施，只需要把scope里的两个orWhereRaw改成whereRaw即可。
• 上述写法完全兼容Laravel7+MySQL环境，不依赖高版本框架方法，直接调用MySQL原生JSON函数，不会出现框架自动生成JSON路径不符合预期的问题，稳定性更高。
• 如果表数据量较大，建议给amenities字段添加JSON类型索引，筛选查询速度会有明显提升。
• 若后续配套设施的筛选、统计、关联需求增多，建议把JSON存储改成多对多关联中间表结构，查询性能和灵活性都会远高于JSON字段，也方便后续扩展设施详情、排序、多语言等功能。

内容的提问来源于stack exchange，提问作者MilAD86