Laravel查询包含数组的JSON字段方法

本文深入解析了在 Laravel 中精准查询 JSON 字段（如存储标签数组的 `fields` 列）是否包含指定值列表中**任一元素**的多种高效方案，直击 `whereIn` 失效、PHP 全量过滤低效等常见痛点，系统对比了 Laravel 9.2+ 原生 `whereJsonContains` 的简洁安全、MySQL `JSON_OVERLAPS` 的高性能单次判定，以及兼容旧版的 `JSON_TABLE` 动态匹配技巧，并强调索引优化实践，助你轻松实现数据库层的智能数组检索，兼顾可读性、兼容性与生产级性能。

本文介绍在 Laravel 中高效查询 JSON 类型字段（如存储标签数组的 fields 列）是否包含给定值列表中至少一个元素的 Eloquent 实现方式，涵盖原生 SQL、JSON 函数及 Laravel 9+ 原生支持方案。

本文介绍在 Laravel 中高效查询 JSON 类型字段（如存储标签数组的 `fields` 列）是否包含给定值列表中至少一个元素的 Eloquent 实现方式，涵盖原生 SQL、JSON 函数及 Laravel 9+ 原生支持方案。

在 Laravel 应用中，若用户表（users）的 fields 列以 JSON 格式存储字符串数组（例如 ["fashion","commercial"]），而你需要检索 至少拥有 "fashion"、"food" 或 "sport" 中任一标签 的用户，直接使用 whereIn('fields', [...]) 是无效的——因为该语句会尝试匹配整个 JSON 字符串（如 ["fashion","commercial"]），而非其内部元素。

✅ 正确做法需借助数据库的 JSON 函数进行数组元素级匹配。以下是跨版本兼容、性能可控的推荐方案：

✅ 方案一：使用 whereJsonContains()（Laravel 9.2+ 推荐）

Laravel 9.2 起原生支持 JSON 数组包含查询，语法简洁且安全：

$targetTags = ['fashion', 'food', 'sport'];

$users = User::where(function ($query) use ($targetTags) {
    foreach ($targetTags as $tag) {
        $query->orWhereJsonContains('fields', $tag);
    }
})->get();

⚠️ 注意：whereJsonContains() 对每个 $tag 生成独立 JSON_CONTAINS(fields, '"tag"') 条件，适用于中小型数据集；大量标签时建议改用方案二。

✅ 方案二：单次查询 + MySQL JSON 函数（高效率，推荐 Laravel 8+）

利用 MySQL 的 JSON_OVERLAPS()（MySQL 8.0.17+）实现一次判定：

$targetJson = json_encode(['fashion', 'food', 'sport']);
$users = User::whereRaw('JSON_OVERLAPS(fields, ?)', [$targetJson])->get();

或兼容更低 MySQL 版本（5.7+）的 JSON_CONTAINS 配合 JSON_EXTRACT：

// 将目标数组转为 JSON，逐个检查是否被 fields 包含
$targetTags = ['fashion', 'food', 'sport'];
$placeholders = str_repeat('?,', count($targetTags) - 1) . '?';
$users = User::whereRaw("EXISTS (
    SELECT 1 FROM JSON_TABLE(fields, '$[*]' COLUMNS (val VARCHAR(255) PATH '$')) AS jt
    WHERE jt.val IN ($placeholders)
)")
->setBindings(array_merge($users->getBindings(), $targetTags))
->get();

❌ 不推荐方案说明

• whereIn('fields', [...])：匹配整列 JSON 字符串，非数组元素，必然失败；
• 全量 PHP 过滤（如 array_intersect()）：将全部用户加载到内存再过滤，严重浪费资源与内存，仅限极小数据集临时调试。

? 补充：确保数据库索引优化

若查询频繁，建议为 fields 列添加生成列并建索引（MySQL 5.7+）：

ALTER TABLE users 
ADD COLUMN fields_search TEXT AS (fields) STORED,
ADD INDEX idx_fields_search (fields_search);

或使用 MySQL 8.0+ 的函数索引（需确认版本支持）：

CREATE INDEX idx_fields_json ON users ((CAST(fields AS CHAR)));

综上，优先采用 whereJsonContains() 多条件 OR 查询（清晰安全），数据量大或需极致性能时，选用 JSON_OVERLAPS() 单次判定。避免全量拉取+PHP 过滤，始终让数据库承担其擅长的集合运算职责。

理论要掌握，实操不能落！以上关于《Laravel查询包含数组的JSON字段方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！