子查询和JSON字段操作在Laravel中能共存但不可混用：where('meta->id', DB::raw('...'))错误，须拆分或改用whereRaw；子查询不能直接用于JSON路径右侧，需先取值再查询；JSON字段参与FROM/SELECT子查询时必须用DB::raw包裹原生JSON函数；whereJsonContains不支持子查询参数，需toArray()预处理；高频查询应改用关联表或生成列索引。
直接说结论：子查询和 JSON 字段操作在 Laravel 中能共存，但不能混用在同一个 where 条件里——比如 where('meta->id', DB::raw('...')) 是错的；必须拆开或改用 whereRaw + 原生 JSON 函数。
子查询里不能直接引用 JSON 字段路径
你写 where('settings->theme', DB::table('defaults')->select('value')->where('key', 'theme')) 会报错，因为 Laravel 不支持把子查询结果直接塞进 JSON 路径语法中。底层生成的 SQL 会把 settings->theme 当作普通列名处理，而子查询返回的是标量值，类型和上下文都对不上。
常见错误现象：
- SQL 报错
Column not found: 1054 Unknown column 'settings->theme' - 查询始终返回空，哪怕数据存在
- PHP 报
Object of class Illuminate\Database\Query\Builder could not be converted to string
正确做法是把子查询提前算出值，再用于 JSON 查询：
- 先执行子查询拿到
$defaultTheme = DB::table('defaults')->where('key', 'theme')->value('value'); - 再用
User::where('settings->theme', $defaultTheme)->get();
JSON 字段参与子查询 FROM 或 SELECT 时要用 raw 包裹
如果你想把 JSON 字段“展开”成虚拟列供子查询使用（比如从 meta 提取 form_id 后做聚合），就必须显式调用数据库函数，不能依赖 -> 语法。
MySQL 示例（查每个 form_id 对应的记录数）：
DB::table(DB::raw("(SELECT JSON_UNQUOTE(JSON_EXTRACT(meta, '$.form_id')) AS form_id FROM submissions) as t"))
->select('form_id', DB::raw('COUNT(*) as cnt'))
->groupBy('form_id')
->get();
PostgreSQL 示例（注意 ->> 提取文本）：
DB::table(DB::raw("(SELECT meta->>'form_id' AS form_id FROM submissions) as t"))
->select('form_id', DB::raw('COUNT(*) as cnt'))
->groupBy('form_id')
->get();
关键点：
-
->语法只在 Eloquent 和 Query Builder 的顶层where/select中有效，进不了子查询的FROM子句 - 不同数据库的 JSON 提取函数不兼容，无法跨库复用这段 SQL
- 若要加索引加速，MySQL 需建生成列 + 普通索引，PostgreSQL 可直接在
meta->>'form_id'上建表达式索引
whereJsonContains 不能嵌套子查询参数
whereJsonContains('meta->tags', DB::table('allowed_tags')->pluck('name')) 看起来合理，但实际会失败——whereJsonContains 第二个参数只接受 PHP 数组或标量，不接受 Query Builder 实例。
容易踩的坑：
- 传入
Collection而不是数组：需显式调用->toArray() - 子查询返回空结果：
whereJsonContains(..., [])在 MySQL 中等价于JSON_CONTAINS(col, '[]')，永远为 false - 字段类型不是原生 JSON：如果
meta是TEXT而非JSON类型，JSON_CONTAINS返回 NULL，整行被过滤掉
安全写法：
$allowed = DB::table('allowed_tags')->pluck('name')->toArray();
if ($allowed) {
$query->whereJsonContains('meta->tags', $allowed);
}
复杂场景建议绕过 JSON 字段，改用关联表
当你频繁需要对 JSON 内容做 JOIN、GROUP BY、ORDER BY 或子查询时，说明设计已超出 JSON 字段适用边界。Laravel 的 JSON 支持本质是“单字段结构化存储”，不是“可查询文档数据库”。
比如这些需求几乎必然导致性能或维护问题：
- 查“所有标签为
urgent且创建时间在最近 7 天的订单”，其中tags存在 JSON 字段里 - 按
meta->user_prefs->language分组统计用户数 - 用
whereJsonContains+whereBetween组合条件查分页数据（MySQL 无法对 JSON 字段建高效复合索引）
真正可落地的替代方案：
- 把高频查询字段（如
form_id、status、priority）单独拆成普通列，保持 JSON 仅存低频、动态、非结构化数据 - 为 JSON 中的数组元素建关联表（如
submission_tags），用标准外键 + 索引支撑任意复杂查询 - 若必须保留 JSON，至少在 MySQL 中为关键路径建生成列并索引：
ALTER TABLE submissions ADD form_id_gen VARCHAR(32) AS (JSON_UNQUOTE(JSON_EXTRACT(meta, '$.form_id'))) STORED;
最常被忽略的一点：JSON 字段的查询性能不取决于 Laravel 写法，而取决于数据库是否能走索引。而绝大多数 JSON 查询（除生成列外）都是全表扫描。
