Laravel子查询需用fromSub()、joinSub()、DB::raw()、whereSub()等方法正确封装，避免裸Builder直传导致SQL错误。
如果您在Laravel中需要基于另一查询结果进行过滤、关联或聚合，则必须正确构造子查询，否则将出现空结果、SQL语法错误或“FUNCTION does not exist”异常。以下是实现Laravel框架子查询的具体操作步骤：
一、使用fromSub()作为主表分页子查询
fromSub()是Laravel 9.27+推荐的主表级子查询方式，适用于需对子查询结果进一步分页、排序或select字段的场景，它自动处理括号包裹与别名绑定，避免手动拼接SQL的风险。
1、定义子查询Builder实例，例如统计每个用户的订单数：
2、调用fromSub()将子查询作为主表，并指定别名：
3、在fromSub()返回的查询构建器上继续链式调用select、where、orderBy等方法：
4、执行get()获取最终结果，Laravel会自动生成类似SELECT * FROM (SELECT user_id, COUNT(*) AS order_count FROM orders GROUP BY user_id) AS counts的合法SQL。
二、使用joinSub()进行关联型子查询
joinSub()用于将子查询以JOIN形式嵌入主查询，特别适合需要将聚合结果（如计数、求和）与主表记录横向关联的场景，比多次N+1查询更高效且语义清晰。
1、构建子查询Builder，仅选择参与JOIN的字段及聚合值：
2、在主表查询中调用joinSub()，传入子查询、别名及ON条件闭包：
3、在select()中明确引用子查询别名的字段，例如counts.order_count：
4、执行get()，生成SQL形如SELECT users.*, counts.order_count FROM users INNER JOIN (SELECT user_id, COUNT(*) AS order_count FROM orders GROUP BY user_id) AS counts ON users.id = counts.user_id。
三、使用DB::raw()显式包裹子查询
当需在select()、where()或orderBy()中直接嵌入子查询表达式时，必须用DB::raw()强制声明其为原始SQL片段，否则Laravel会将其视作字符串字面量导致解析失败。
1、编写子查询SQL字符串，确保含完整SELECT子句及括号：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
2、在目标位置使用DB::raw()包裹该字符串，例如在select()中引入标量子查询：
3、若子查询用于WHERE条件，须配合whereRaw()而非where()：
4、注意所有子查询必须带别名，DB::raw()内字符串末尾需显式添加 AS alias_name，否则MySQL报错。
四、使用whereSub()替代IN子查询
whereSub()提供类型安全的子查询WHERE条件写法，用于替代传统whereIn()中传入数组的方式，尤其适用于动态生成ID列表且来源为另一查询的情形。
1、构造返回单列结果的子查询Builder，例如获取活跃用户ID：
2、在主查询中调用whereSub()，传入目标字段名与子查询Builder：
3、Laravel自动将子查询转为WHERE field IN (SELECT id FROM users WHERE status = 1)结构：
4、该方法避免了手写whereRaw()可能引发的SQL注入风险，且支持Eloquent模型上下文绑定。
五、避免直接传Builder进select()或where()
直接将未包装的QueryBuilder实例传入select()或where()参数位是常见错误，Laravel不会自动调用toSql()或加括号，而是将其转为字符串Illuminate\Database\Query\Builder Object，导致SQL语法崩溃。
1、切勿写作->select(DB::table('orders')->where('user_id', 'users.id')->count())：
2、也不应写作->where('id', DB::table('temp')->pluck('id'))（pluck返回Collection，非Builder）：
3、验证子查询是否生效：调用$sub->toSql()检查输出是否为合法SELECT语句并含括号：
4、关键提示：所有子查询必须显式包裹于DB::raw()、fromSub()、joinSub()或whereSub()中，禁止裸Builder直传。
