join() 是 laravel 查询构造器唯一表连接入口，默认内连接；需扁平字段、关联表条件过滤或排序时必须用它而非 with()；leftjoin() 的关联条件须用 on() 而非 where()，多表需加前缀或别名，crossjoin() 用于笛卡尔积且需显式别名。
join() 是 Laravel 查询构造器里做表连接的唯一入口，没有 innerJoin()、outerJoin() 这类方法——调用 join() 默认就是内连接，别被名字误导。
什么时候必须用 join() 而不是 with()
当你需要把多张表的字段拼在一行结果里，并且 WHERE 条件或排序依赖关联表字段时，join() 不可替代。
- 查「订单号 + 用户名 + 商品标题」这种混合字段，
with()返回的是嵌套结构，前端还得 flatten；join()直接扁平输出 -
where('products.status', 1)这种条件写在关联表上，用with()+ PHP 层过滤会查出全部再筛，数据库层没生效，性能差还可能爆内存 - 要按「用户最后登录时间」排序订单列表，这个时间在
user_profiles表里，join()才能把它拉进ORDER BY
leftJoin() 别乱用 where，否则变内连接
leftJoin() 的本意是保留左表所有记录，右表无匹配就填 null。但如果你把关联过滤条件（比如软删除）写在 where() 里，MySQL 会先 join 再 where，导致右表为 null 的行被整体干掉。
- 错误写法：
->leftJoin('users', 'orders.user_id', '=', 'users.id')->where('users.deleted_at', null)→ 实际等效于join() - 正确写法：
->leftJoin('users', 'orders.user_id', '=', 'users.id')->on('users.deleted_at', null)→ 条件塞进ON子句 - 多个条件 on：
->on(function ($join) { $join->on('a.x', '=', 'b.y')->whereNotNull('b.z'); })
三张表以上连查，字段名冲突是常态
不加前缀或别名，id、name、created_at 这些字段一出现就报 Column 'id' in field list is ambiguous。
- 所有
select()字段必须带表前缀或别名：'users.name as user_name'，不能只写'name' -
join()时直接加别名：->join('products as p', 'orders.product_id', '=', 'p.id') -
where()和orderBy()也得带前缀：->where('p.status', 1)，不是->where('status', 1) - 别依赖模型的
$appends或访问器——join()是底层 SQL 操作，它们压根不生效
交叉连接只能用 crossJoin()，不能硬套 join()
想生成日期序列、枚举组合这类笛卡尔积场景，crossJoin() 是唯一合法方式。用 join() 不传 on 参数，Laravel 7+ 会直接抛 InvalidArgumentException。
- 子查询做交叉连接，必须用
DB::raw()包裹并显式加AS alias：crossJoin(DB::raw('(SELECT ... ) AS date_gen')) -
crossJoin()后接leftJoin()，on条件里字段必须带子查询别名前缀，比如date_gen.date_gen，漏掉date_gen.就报错 - 交叉连接极易触发数据爆炸——1000 用户 × 365 天 = 36.5 万行，上线前务必加
limit或前置过滤
join() 之后，select('*') 会覆盖同名列、where() 会悄悄吞掉左连接的空记录、三张表不加别名就跑不起来——这些坑不在文档首页，但在每次 get() 报错时真实存在。
