whereHas 必须用闭包传子查询，直接传 Builder 实例会失效；addSelect 子查询需防 NULL 和类型不一致；joinSub() 安全替代手写 JOIN；whereHas 与 with() 配合实现筛选+预加载，避免 N+1。
whereHas 里嵌套子查询必须用闭包，不能直接传 Builder 实例
很多人写 whereHas('posts', Post::where('status', 'published'))，结果报错或查不到数据。这是因为 whereHas 的第二个参数必须是闭包，Laravel 才会把它当作子查询执行；直接传 Builder 实例会被当普通对象忽略，甚至触发 PHP 警告。
正确写法是显式包裹闭包：
$users = User::whereHas('posts', function ($query) {
$query->where('status', 'published')
->where('created_at', '>', now()->subWeek());
})->get();
- 闭包里的
$query是关联模型的查询构建器，作用域已自动绑定外键（如user_id = users.id） - 如果关联是多对多（如
tags），闭包内操作的是中间表 + 关联表的联合上下文 - 避免在闭包外提前调用
->get()或->toSql()，否则子查询失效
addSelect 子查询字段要防 NULL 和类型不一致
用 addSelect() 给主查询加子查询字段（比如每个用户的最新订单时间），常见问题是字段值为 NULL 或类型错乱（如返回字符串而非时间戳）。
根本原因在于子查询没处理「无匹配记录」的情况，且未显式指定字段别名和类型：
$users = User::select('users.*')
->addSelect(['last_order_at' => Order::select('created_at')
->whereColumn('user_id', 'users.id')
->orderByDesc('created_at')
->limit(1)
])
->get();
- 若某用户无订单，
last_order_at字段值为NULL，前端可能报错；需要加COALESCE或后端判空 - Laravel 不会自动把子查询结果转成 Carbon 实例，
last_order_at是原始字符串，要用asDateTime()或访问时手动转换 - 子查询中
whereColumn()必须用字符串（如'users.id'），不能写成$user->id，否则变成固定值查询
joinSub() 替代手写 JOIN，避免括号和别名错误
想把子查询当临时表来 JOIN（比如查每个用户最新一条订单），直接拼 SQL 容易漏括号、错别名、引号不匹配，MySQL 报 SQLSTATE[HY000]: General error: 1305 FUNCTION xxx does not exist 就是典型症状。
joinSub() 是 Laravel 9+ 推荐方式，它自动处理括号包裹、参数绑定和别名校验：
$latestOrders = Order::select('user_id', DB::raw('MAX(created_at) as last_at'))
->groupBy('user_id');
$users = User::joinSub($latestOrders, 'latest', function ($join) {
$join->on('users.id', '=', 'latest.user_id');
})->get();
-
joinSub()第二个参数（别名）不能是 MySQL 保留字，比如order、group、user都会报语法错误 - 子查询里如果有
ORDER BY+LIMIT（如取最新一条），joinSub()能正常工作；但whereExists()无法实现同类逻辑 - 如果子查询本身含聚合（如
COUNT(*)），记得在selectRaw里显式起别名，否则字段名不可预测
with() 预加载 + whereHas() 筛选，别混用 load()
想查「有已发布文章的用户」并同时拿到这些文章内容，有人写 User::whereHas('posts')->load('posts')，这会导致两次查询：第一次用 EXISTS 筛用户，第二次再单独查所有匹配用户的 posts —— 白费一次 IO。
正确组合是 whereHas() 筛 + with() 预加载，一查到底：
$users = User::whereHas('posts', fn ($q) => $q->where('status', 'published'))
->with(['posts' => fn ($q) => $q->where('status', 'published')])
->get();
-
with()的闭包条件和whereHas()的条件最好保持一致，否则可能查出用户但 posts 为空（比如whereHas查 status=published，with却没加条件） -
load()是运行时懒加载，只适合单个模型实例后续补数据；批量场景必须用with()放在get()前 - 如果关联是
belongsTo（如 Post → User），whereHas()不适用，得用whereExists()或反向查 User 表加 JOIN
with() 加闭包做不到，必须走 joinSub() 或原生子查询。 
