Laravel 中必须用 joinSub 实现子查询 JOIN，它将子查询封装为虚拟表参与连接；需传 Builder 或闭包、必填别名、显式指定字段并重命名冲突列，不可调用 get()，别名须唯一且合法。
用 joinSub 实现子查询 JOIN，不是 join
PHP 中 Laravel 的 Eloquent 本身不支持直接在 join 里写子查询（比如 DB::table('users')->join('SELECT ...', 'alias', ...) 会报错），必须用 joinSub —— 这是关键前提。它把子查询封装成一个“虚拟表”，再参与连接，底层生成标准 SQL 的 JOIN (SELECT ...) AS alias。
常见错误是试图传入 Builder 实例却漏掉别名，或误用 fromSub（那是给主查询换表用的）。
-
joinSub第一个参数是子查询（Builder或闭包），第二个是别名（字符串，必填），第三、四、五参数才是 on 条件（字段、操作符、值） - 子查询里不要调用
get()或first()，保持它是未执行的Builder - 别名不能含空格或特殊字符，否则生成 SQL 会出错；推荐全小写 + 下划线，如
latest_orders
子查询里用 selectRaw 控制字段，避免 * 带来冲突
子查询 SELECT 的字段名如果和主表重复（比如都选了 id），后续 ->get() 取值时会覆盖——Laravel 默认用键名合并结果，同名字段只保留最后一个。这不是 bug，是 PDO 返回模式决定的。
所以必须显式指定子查询要返回哪些字段，尤其要重命名冲突列：
立即学习“PHP免费学习笔记（深入）”；
$sub = DB::table('orders')
->selectRaw('user_id, MAX(created_at) as latest_order_at, COUNT(*) as order_count')
->groupBy('user_id');
<p>User::joinSub($sub, 'latest_orders', 'users.id', '=', 'latest_orders.user_id')
->select('users.name', 'latest_orders.latest_order_at', 'latest_orders.order_count')
->get();
- 别用
select('*')在子查询里，哪怕只是临时调试 - 聚合函数（
MAX、COUNT）必须配合GROUP BY，否则 MySQL 会报错（严格模式下） - 如果子查询需要关联其他表，直接在子查询内部
join，不要指望外层再连
关联多对多中间表时，joinSub 比 withCount 更灵活
比如查“每个用户最近一条评论的时间”，withCount 只能统计数量，没法取时间字段；而 withMax('comments.created_at') 是 Laravel 9+ 才有，且不支持复杂条件。这时候 joinSub 是最稳的选择。
注意：子查询中若引用主表字段（如 users.id），不能直接写，要用 DB::raw 包裹并确保外部作用域可访问：
$sub = DB::table('comments')
->select('commentable_id', DB::raw('MAX(created_at) as last_comment_at'))
->where('commentable_type', 'App\Models\User')
->groupBy('commentable_id');
<p>User::joinSub($sub, 'user_comments', 'users.id', '=', 'user_comments.commentable_id')
->select('users.name', 'user_comments.last_comment_at')
->get();
- 子查询里不能直接写
users.id，因为它是外部查询的表，子查询作用域看不到 - 如果子查询需动态过滤（比如只取某类用户的评论），建议提前用变量绑定，而不是拼 SQL 字符串
- 性能上，子查询会先执行一次（带 GROUP BY），再和主表 JOIN，数据量大时注意加索引：
comments.commentable_type + commentable_id + created_at
嵌套子查询或多次 joinSub 时，别名必须唯一
同一个查询里用两次 joinSub，别名重复会导致 SQL 报错：「Every derived table must have its own alias」。MySQL 要求每个子查询都有独立别名，且不能和主表或其他子查询别名相同。
容易被忽略的是：Eloquent 查询构建器在链式调用中不会自动去重别名，全靠你手动管理。
- 别名建议带语义前缀，比如
active_orders、pending_reviews，而不是都叫sub1、sub2 - 如果子查询逻辑复杂，抽成独立方法或本地作用域（
scopeWithLatestOrder），便于复用和测试 - 调试时可用
toSql()看最终 SQL，但注意它不展开绑定参数，要结合dd(DB::getQueryLog())看实际执行语句
子查询 JOIN 的本质是让数据库做关联计算，不是 PHP 循环拼接。写错别名、漏字段重命名、或在子查询里调用 get()，这三处出问题的概率最高。
