Laravel通过pivot中间表关联第三模型查询报错排查

当前代码存在4个核心错误，直接导致报错和逻辑不符合预期：

• 中间表名、关联外键顺序配置错误：你实际创建的中间表名为category_courses，但模型关联中写的是course_categories；同时Category模型中courses关联的外键顺序写反，belongsToMany的第三个参数应为当前模型（Category）在中间表的外键category_id，第四个参数为关联模型（Course）在中间表的外键course_id，原代码顺序颠倒会导致关联查询结果完全错误。
• 关联场景使用错误：你在Category模型中定义的hasOneThrough完全不符合业务逻辑。hasOneThrough用于跨一张中间表实现一对一关联，但分类和教师不存在直接的跨中间表一对一关系——教师是挂载在课程模型下的关联，不需要在Category层单独定义teacher关联。且该关联未传全参数，Laravel默认会去teachers表查找不存在的course_category_id字段，直接触发你看到的SQL报错。
• 控制器查询逻辑错误：findOrFail($id)会直接返回主键匹配的Category模型实例，后续接->first()属于多余调用，会触发额外的全量查询；另外你写的Category::with('courses','teacher')->get()会查询出系统所有分类数据，和当前要访问的单个分类需求完全无关，属于冗余错误代码。
• 关联命名不规范：Course模型和Teacher是属于一对一的从属关系（一个课程对应一个授课教师），但关联方法名用了复数teachers，和belongsTo的关联语义不匹配，后续调用很容易出现混淆。

1. 修正模型关联 #

先删除Category模型中错误的teacher关联，修正courses关联配置：

class Category extends Model
{
    use HasFactory;

    protected $fillable = [
        'name'
    ];

    public function courses()
    {
        // 对齐真实中间表名，修正外键顺序
        return $this->belongsToMany(Course::class, 'category_courses', 'category_id', 'course_id');
    }
}

再修正Course模型的教师关联命名和对应参数：

class Course extends Model
{
    use HasFactory;

    protected $fillable = [
        'name','description','cover','difficulty', 'teacher_id'
    ];

    // 方法名改为单数，匹配belongsTo的单关联语义
    public function teacher() {
        return $this->belongsTo(Teacher::class, 'teacher_id', 'id');
    }

    public function categories() {
        return $this->belongsToMany(Category::class, 'category_courses', 'course_id', 'category_id');
    }
}

Teacher模型原有代码不需要调整。

2. 修正控制器查询逻辑 #

使用Laravel的嵌套预加载能力，一次性查询当前分类、分类下所有课程、每门课程对应的教师，避免N+1查询问题，删除冗余的全量分类查询：

public function show($id)
{
    // 嵌套预加载courses下的teacher关联，直接查询目标分类
    $category = Category::with('courses.teacher')->findOrFail($id);
    return view('admin.showcoursesbycategory', compact('category'));
}

3. 视图层渲染示例 #

在视图文件中直接遍历关联数据渲染卡片即可：

<div class="container">
    <h1>分类：{{ $category->name }}</h1>
    <div class="row">
        @foreach($category->courses as $course)
        <div class="col-md-4 mb-4">
            <div class="card">
                <div class="card-body">
                    <h5 class="card-title">{{ $course->name }}</h5>
                    <p class="card-text">授课教师：{{ $course->teacher->name }}</p>
                </div>
            </div>
        </div>
        @endforeach
    </div>
</div>

注意：如果你实际数据库中的中间表名确实是course_categories而非最初定义的category_courses，只需要把所有关联配置中的中间表名替换为你数据库里的真实表名即可，必须保证关联配置和数据库结构完全一致。

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