Laravel子查询必须用fromSub()、joinSub()或addSelect()等安全方法，禁用手拼SQL；fromSub()需显式别名，joinSub()用闭包写on条件，addSelect()标量子查询须limit(1)防报错，whereExists()仅适用于存在性判断。
子查询在 Laravel 里不是“拼 SQL 字符串”就能跑通的事，写错直接报 Syntax error 或返回空结果——核心问题在于：Laravel 默认不把 Builder 实例当子查询处理，必须显式封装、加别名、防绑定丢失。
fromSub() 是子查询当主表的唯一安全写法
当你需要对聚合、分组或带 LIMIT 的结果再分页、排序或筛选时，fromSub() 是 Laravel 9.27+ 唯一推荐方式。它自动包裹括号、注入绑定参数、强制要求别名，杜绝手拼风险。
-
fromSub()第二个参数是必需的字符串别名（如'latest_posts'），不能省略，也不能用 MySQL 保留字（比如'order'） - 子查询本身不能调
->get()或->toSql()，否则会断掉绑定上下文 - 如果子查询含
ORDER BY + LIMIT（例如取每个用户的最新一条订单），fromSub()能正常工作；whereExists()则完全不适用 - 示例：
$sub = DB::table('orders')->select('user_id', DB::raw('MAX(created_at) as latest_at'))->groupBy('user_id');<br>$result = DB::table()->fromSub($sub, 'latest_orders')->join('users', 'users.id', '=', 'latest_orders.user_id')->select('users.name', 'latest_orders.latest_at')->get();
joinSub() 替代手写 JOIN 子查询
想把聚合结果（如订单数、总金额）和主表横向关联，joinSub() 比手动拼 DB::raw("(...) AS sub") 稳定得多。它自动处理子查询的参数绑定和别名，避免 FUNCTION does not exist 这类报错。
- 子查询中只选真正用于
ON条件和SELECT的字段，别select('*')—— 多余字段会拖慢性能且可能触发 MySQL 8.0+ 的ONLY_FULL_GROUP_BY错误 -
joinSub()的第三个参数是闭包，里面用$join->on()写关联条件，不是where() - 主查询的
select()必须显式引用子查询别名，如'counts.order_count'，不能只写'order_count' - 示例：
$sub = DB::table('orders')->select('user_id', DB::raw('COUNT(*) as order_count'))->groupBy('user_id');<br>User::select('users.*', 'counts.order_count')<br> ->joinSub($sub, 'counts', function ($join) {<br> $join->on('users.id', '=', 'counts.user_id');<br> })->get();
addSelect() 里嵌标量子查询要防 NULL 和类型错乱
给主查询加一个“每个用户的最新订单时间”这类字段，用 addSelect() 最简洁，但子查询没处理边界情况就会出问题：字段为 null、时间格式是字符串、字段名拼错都常见。
- 子查询必须用
Order::select('created_at')这种模型静态调用，不能用DB::table()—— 否则whereColumn()无法正确绑定外键 - 务必加
->limit(1)，否则 MySQL 可能报 “Subquery returns more than 1 row” - 若用户无订单，该字段值为
null，取值时得判空：$user->last_order_at ?? now() - 时间字段不会自动转成
Carbon，要用asDateTime()或在访问时手动转换 - 示例：
User::select('users.*')<br> ->addSelect(['last_order_at' => Order::select('created_at')<br> ->whereColumn('orders.user_id', 'users.id')<br> ->orderByDesc('created_at')<br> ->limit(1)<br> ])->get();
whereExists() 不是万能替代，慎用代替 whereIn()
whereExists() 只适合存在性判断，不是为了“优雅”而硬套。滥用会导致每行主表数据都执行一次子查询（DEPENDENT SUBQUERY），性能比 whereIn() 差一个数量级。
- 子查询里不要
select('*')或select('id')—— 只需select(DB::raw(1))或干脆不写select()，让数据库快速判断是否存在即可 - 关联字段类型必须严格一致：主表
user_id是unsignedBigInteger，子查询里where('user_id', ...)的值就得是整型，传字符串会触发隐式转换，索引失效 - 想实现“查所有有未读通知的用户”，正确写法是：
User::whereExists(function ($q) {<br> $q->from('notifications')<br> ->whereColumn('notifications.user_id', 'users.id')<br> ->where('read_at', null);<br>}) - 如果子查询逻辑简单、ID 列表可控（比如几百条），
whereIn('id', $ids)仍是更快更稳的选择
最常被忽略的一点：所有子查询里的字段引用（尤其是 whereColumn()、join() 条件）必须用字符串形式的列名（如 'users.id'），不能用变量（如 $user->id）—— 后者会让子查询变成固定值查询，彻底失去关联语义。
