本文介绍在 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+）实现一次判定：
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
$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 过滤，始终让数据库承担其擅长的集合运算职责。
