Laravel Eloquent自定义查询构建器中如何避免重复Join？

方案一：检查已存在的Join再决定是否添加 #

直接在自定义构建器方法中，通过getQuery()->joins获取当前已有的Join语句，判断目标表是否已经被Join过，避免重复添加：

class UserBuilder extends Builder
{
    public function withActiveCompany(): self
    {
        // 遍历已有的Join，检查是否已关联companies表
        $hasCompaniesJoin = collect($this->getQuery()->joins)->some(function ($join) {
            return $join->table === 'companies';
        });

        // 只有未关联时才执行Join操作
        if (!$hasCompaniesJoin) {
            $this->join('companies', 'users.company_id', 'companies.id');
        }

        return $this->where('companies.is_active', true);
    }
}

方案二：改用Eloquent关联查询（推荐） #

利用Laravel自带的关联关系替代手动Join，Eloquent会自动处理重复关联的问题，不会生成重复的Join语句：

1. 先在User模型中定义与Company的关联：

class User extends Model
{
    public function company()
    {
        return $this->belongsTo(Company::class);
    }
}

2. 修改自定义构建器的方法，使用whereHas实现查询条件：

class UserBuilder extends Builder
{
    public function withActiveCompany(): self
    {
        return $this->whereHas('company', function ($query) {
            $query->where('is_active', true);
        });
    }
}

这种方式更符合Laravel的设计理念，同时彻底避免了重复Join的问题，代码可读性也更强。

方案三：使用表别名（可选） #

如果必须使用手动Join，可以给表指定别名，同时检查别名是否已存在，避免冲突：

class UserBuilder extends Builder
{
    public function withActiveCompany(): self
    {
        $alias = 'companies_active';
        // 检查是否已通过原表名或别名关联过
        $hasJoin = collect($this->getQuery()->joins)->some(function ($join) use ($alias) {
            return $join->table === 'companies' || $join->alias === $alias;
        });

        if (!$hasJoin) {
            $this->join('companies as ' . $alias, 'users.company_id', $alias . '.id');
        }

        return $this->where($alias . '.is_active', true);
    }
}

不过这种方式需要统一使用别名，相对繁琐，仅在特殊场景下使用。

内容的提问来源于stack exchange，提问作者Chris