Laravel 8中如何预加载关联到中间表的多对多关系？

要实现从Class模型预加载Teacher数据，核心是利用Laravel对自定义中间表（Pivot）模型的关联预加载支持，通过嵌套预加载语法一次性拉取所有关联数据，彻底解决懒加载带来的N+1查询问题。

前提确认 #

先确保你的模型关系定义正确：

1. Class模型的periods关联已指定自定义中间模型：

// app/Models/Class.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Class extends Model
{
    public function periods()
    {
        return $this->belongsToMany(Period::class)
            ->using(ClassPeriod::class) // 指定自定义中间表模型
            ->withTimestamps(); // 若中间表包含时间戳字段请添加
    }
}

2. ClassPeriod模型（需继承Pivot类）已定义teachers关联：

// app/Models/ClassPeriod.php
namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class ClassPeriod extends Pivot
{
    public function teachers()
    {
        return $this->belongsToMany(Teacher::class);
    }
}

预加载实现方式 #

通过嵌套预加载的点语法，直接在with方法中指定periods.pivot.teachers，即可一次性加载Class、关联的Period、中间表ClassPeriod以及对应的Teacher数据：

// 预加载所有班级、关联课时、课时对应的教师
$classes = \App\Models\Class::with('periods.pivot.teachers')->get();

// 遍历访问，无额外查询
foreach ($classes as $class) {
    foreach ($class->periods as $period) {
        // 直接访问预加载完成的教师集合
        $teachers = $period->pivot->teachers;
        foreach ($teachers as $teacher) {
            // 示例：输出教师名称
            echo $teacher->name . '<br>';
        }
    }
}

替代方案：直接定义Class到Teacher的关联 #

如果业务场景不需要Period数据，只想直接从Class获取关联的Teacher，可以在Class模型中新增跨中间表的多对多关联：

// app/Models/Class.php
public function teachers()
{
    // 假设ClassPeriod与Teacher的中间表名为class_period_teacher
    return $this->belongsToMany(Teacher::class, 'class_period_teacher')
        ->join('class_period', 'class_period.id', '=', 'class_period_teacher.class_period_id')
        ->where('class_period.class_id', '=', $this->id)
        ->select('teachers.*');
}

此时只需执行Class::with('teachers')->get()即可直接预加载班级对应的所有教师。

关键说明 #

• 预加载periods.pivot.teachers是Laravel官方支持的用法，完全可行，能有效优化查询性能。
• 无需依赖$appends或访问器逻辑，预加载的数据会直接挂载到pivot实例上，代码更简洁高效。

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