子查询连接条件在 Laravel 中必须用 joinSub 实现，因 join() 仅接受表名或原始字符串、不解析子查询，硬写 SELECT 会报语法错误；joinSub 要求首参为未执行 Builder 或闭包、次参为合法别名、ON 条件顺序正确，且子查询须显式重命名冲突字段、禁用 get() 等执行方法。
子查询连接条件在 Laravel 中不能靠 with 或 whereHas 实现，必须用 joinSub —— 这是唯一能将子查询作为“虚拟表”参与 JOIN 的方法。
为什么不能在 join() 里直接写 SELECT 子查询？
Laravel 查询构建器的 join() 只接受表名或原始字符串，不解析 SQL 子查询。传入类似 'SELECT * FROM orders WHERE user_id = users.id' 会直接拼进 SQL，导致语法错误（如 MySQL 报错 ERROR 1064）或字段无法识别。
-
join()底层只做字符串拼接，不校验子查询合法性 - 即使你手动写对了 SQL 结构，Eloquent 也无法为子查询中的字段生成别名或处理字段冲突
- 想让子查询带 GROUP BY、聚合函数、多表关联，
join()完全无能为力
joinSub 的参数怎么填才不报错？
joinSub 第一个参数必须是未执行的 Builder 实例或闭包，第二个参数是别名（必填且合法），后面才是 ON 条件；漏掉别名或传错类型，立刻抛出 InvalidArgumentException。
- 别名不能含空格、点号、连字符，推荐全小写+下划线，如
'latest_orders' - 子查询里严禁调用
get()、first()、pluck()等执行方法，否则报错Call to a member function addSelect() on array - ON 条件的第三、四、五参数对应
leftField、operator、rightField，顺序错乱会导致 JOIN 条件失效 - 如果子查询要关联其他表，必须在子查询内部
join()，外层joinSub不支持再连
子查询字段重命名为什么不是可选项？
当子查询和主表都有 id、name 等同名字段时，PDO 默认以键名合并结果集，后出现的字段值会覆盖前面的——这不是 Laravel 的 bug，是底层 fetch 模式决定的。你查出来 $row['id'] 是子查询的还是主表的，完全不可控。
- 必须用
selectRaw()显式列出子查询字段，并对冲突列重命名，例如'user_id as sub_user_id' - 避免在子查询中用
select('*')，哪怕只是调试，它会放大字段冲突风险 - 聚合函数（
COUNT、MAX）必须配groupBy()，否则 MySQL 严格模式下直接报错 - 若需取“每个用户最新一条评论时间”，
withMax('comments.created_at')在 Laravel 9+ 才支持，且无法加复杂条件（比如status = 'approved'），这时joinSub是唯一可靠路径
whereHas 和 joinSub 的本质区别在哪？
whereHas 是 EXISTS 子查询，只判断“有没有符合条件的关联记录”，不返回子表字段；joinSub 是真正 JOIN，能把子查询结果当表用，字段可选、可排序、可分页、可参与后续 where。
- 要筛选“有已发布文章的用户”，用
whereHas('posts', fn($q) => $q->where('status', 'published')) - 要查“每个用户最新发布文章的标题和发布时间”，必须用
joinSub，因为whereHas根本不提供字段 - 想同时满足“有已发布文章”且“最新一篇发布时间 > 2025-01-01”，
whereHas+with()会触发两次查询，而joinSub一次搞定 - 别名重复、子查询执行过早、字段没重命名——这三个问题占了
joinSub报错的 90%
