Laravel9关联表预加载优化实现方案咨询

问题场景 #

使用Laravel 9开发多关联表项目，当前已实现Main与Member的多对多关联，在MainController的index方法中通过with('members')预加载关联数据，但当数据量增大（50条Main、近100条Member）时出现大量重复查询，需优化预加载逻辑。

已有的表结构 #

基础配置表

核心业务表

已定义的模型关联 #

• Type → Main（一对多）：

public function mains()
{
   return $this->hasMany(Main::class);
}

• Gender/Qualification/Occupation → Member（一对多）：

// 以Gender为例，另外两个模型写法一致
public function member()
{
   return $this->hasMany(Member::class);
}

• Main ↔ Member（多对多）：

public function members()
{
   return $this->belongsToMany(Member::class);
}

当前控制器代码 #

public function index()
{
   $this->data['warga'] = Main::with('members')->get();
   $this->data['title'] = 'Family list';
   return $this->adminTheme('family.index', $this->data);
}

优化步骤 #

1. 嵌套预加载Member的关联模型 #

出现大量查询的核心原因是：你只预加载了Main的members关联，但如果在视图中调用了Member的gender、qualification、occupation关联，Laravel会触发N+1查询（每个Member单独发起一次关联表查询）。

修改控制器中的预加载逻辑，嵌套加载Member的所有关联：

public function index()
{
    // 嵌套预加载Member的关联模型，批量获取所有关联数据
    $this->data['warga'] = Main::with([
        'members.gender',
        'members.qualification',
        'members.occupation'
    ])->get();
    
    $this->data['title'] = 'Family list';
    return $this->adminTheme('family.index', $this->data);
}

2. 修正Member模型的反向关联 #

当前父模型（Gender/Qualification/Occupation）的hasMany关联是正确的，但Member模型缺少对应的belongsTo反向关联，这是预加载的基础。在Member.php中添加：

public function gender()
{
    return $this->belongsTo(Gender::class);
}

public function qualification()
{
    return $this->belongsTo(Qualification::class);
}

public function occupation()
{
    return $this->belongsTo(Occupation::class);
}

同时确认members表中存在gender_id、qualification_id、occupation_id这三个外键字段（表结构描述中可能遗漏，需确保字段存在）。

3. 可选：限制预加载字段（性能进阶） #

如果不需要关联表的所有字段，可以指定只加载业务需要的字段，减少数据传输量：

$this->data['warga'] = Main::with([
    'members' => function ($query) {
        // 只加载Member的必要字段，必须包含关联外键
        $query->select('id', 'main_id', 'full_name', 'gender_id', 'qualification_id', 'occupation_id');
    },
    'members.gender:id,name', // 只加载Gender的id和name
    'members.qualification:id,name',
    'members.occupation:id,name'
])->get();

注意：belongsTo关联预加载时必须包含id字段，否则无法匹配关联数据。

4. 验证优化效果 #

可以通过Laravel查询日志确认查询次数：

// 在index方法开头启用查询日志
DB::enableQueryLog();

// 获取数据后打印日志
dd(DB::getQueryLog());

优化后应该只有5条左右的查询：

1. 查询mains表
2. 批量查询所有关联的members表
3. 批量查询members对应的genders表
4. 批量查询members对应的qualifications表
5. 批量查询members对应的occupations表
   彻底解决之前的N+1重复查询问题。

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