Laravel模型自关联附加属性自动加载超时问题解决

原代码触发60秒超时的核心原因有四个，叠加后直接导致查询量爆炸：

• 全局附加属性强制触发查询：将main_branch、all_branches挂到模型全局$appends数组后，任何场景只要实例化Company模型（哪怕仅查询公司基础ID、名称做下拉选择），都会强制执行对应访问器的查询逻辑，产生大量完全不必要的数据库请求
• 命名冲突覆盖原生关联逻辑：附加属性名和Eloquent关联方法重名，直接覆盖了框架自带的关联访问能力，让本来可以预加载复用的关联数据，变成每次访问都触发独立查询的逻辑
• 经典N+1查询问题：两个访问器没有做查询复用，每次都直接执行$this->main_branch()->first()、$this->branches()->get()独立查询逻辑，只要遍历10条公司记录，就会额外触发20次独立SQL查询，数据量稍大就会直接打满执行时间
• 递归无限查询风险：由于关联是自关联（所有父/子分支本身也是Company模型实例），模型全局挂载的附加属性查询逻辑会随关联加载层层触发，形成无限循环的SQL调用，最终触发最大执行时间限制

第一步：移除全局附加属性的强制挂载 #

首先把会触发全场景强制查询的$appends配置移除，从根源上避免无意义的查询触发：

class Company extends Model 
{
    public $table = 'companies';

    // 删除原有的全局appends配置，避免所有场景强制加载关联
    // protected $appends = ['main_branch', 'all_branches'];

    // 保留标准Eloquent自关联定义
    public function branches()
    {
        return $this->hasMany(self::class, 'parent_id', 'id');
    }

    public function main_branch()
    {
        return $this->belongsTo(self::class, 'parent_id');
    }
}

第二步：用全局预加载实现自动加载关联 #

要实现“控制器获取Company数据时自动带上父级、子级分支”的需求，不要在访问器里写独立查询，而是通过Eloquent全局作用域，给所有Company查询默认加上预加载逻辑，让框架一次性批量取出关联数据，从根本上消除N+1问题：

protected static function boot()
{
    parent::boot();
    // 所有Company查询默认自动预加载主分支、子分支关联
    static::addGlobalScope('autoLoadBranches', function (Builder $builder) {
        $builder->with(['main_branch', 'branches']);
    });
}

// 调整关联定义，给关联查询排除递归全局作用域，避免无限循环加载
public function branches()
{
    return $this->hasMany(self::class, 'parent_id', 'id')
        ->withoutGlobalScope('autoLoadBranches');
}

public function main_branch()
{
    return $this->belongsTo(self::class, 'parent_id')
        ->withoutGlobalScope('autoLoadBranches');
}

这种方式的查询效率极高：哪怕查询1000条公司记录，也只会固定执行2次关联查询（一次查所有关联的主分支、一次查所有关联的子分支），不会再出现单条记录触发独立查询的问题，从根本上避免超时。

第三步：删除冗余的重复访问器 #

原代码里的getMainBranchAttribute()、getAllBranchesAttribute()完全是重复逻辑：因为通过预加载的关联，本来就可以直接通过$company->main_branch、$company->branches访问对应数据，这两个访问器每次访问还会重新触发一次独立查询，属于纯粹的性能负担，直接删除即可：

// 直接删除以下冗余代码
// public function getMainBranchAttribute(){ 
//     return $this->main_branch()->first();
// }
// public function getAllBranchesAttribute(){ 
//     return $this->branches()->get();
// }

第四步：灵活控制加载范围 #

如果部分场景不需要加载分支关联，可以临时排除全局作用域减少查询开销：

• 仅查询基础公司数据做下拉选择时：

  $companyOptions = Company::withoutGlobalScope('autoLoadBranches')
      ->get(['id', 'company_name']);
  

• 需要自定义分支过滤规则（比如仅获取已审核的分支）时：

  $companies = Company::withoutGlobalScope('autoLoadBranches')
      ->with([
          'main_branch',
          'branches' => fn($query) => $query->where('audit_status', 1)
      ])
      ->get();
  

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