Laravel Scope查询wherePivot问题：关联中间表日期字段异常

我来帮你理清这个问题的关键和解决思路——你大概率是混淆了wherePivot的适用场景，或者关联定义时漏了关键配置：

首先明确两个核心要点：

• wherePivot的正确用法：它是用来过滤已加载的关联模型集合的（比如你拿到某个Workout后，要筛选它关联的、中间表date为今天的Week）；如果是直接查询所有符合中间表日期条件的Workout，得用whereHas或者直接关联中间表做数据库层面的筛选。
• 必须显式声明中间表字段：Laravel默认只加载多对多关联的外键，中间表的自定义字段（比如你的date）需要在关联定义里用withPivot()指定，不然pivot对象里根本不会包含这个字段。

第一步：修正模型关联定义 #

在Workout.php里，确保你的weeks关联正确声明中间表和需要加载的字段：

public function weeks()
{
    return $this->belongsToMany(Week::class, 'week_workout')
                ->withPivot('date'); // 关键！必须加这个才能访问pivot.date
}

第二步：编写正确的Scope查询 #

如果你想写一个Scope来获取今天对应的Workout，用whereHas关联中间表条件是最直接的方式（数据库层面查询，效率更高）：

use Carbon\Carbon;

public function scopeToday($query)
{
    return $query->whereHas('weeks', function ($subQuery) {
        // 直接用中间表的表名+字段名来指定条件
        $subQuery->where('week_workout.date', Carbon::today()->toDateString());
    });
}

之后在控制器里调用就很简单：

$todayWorkouts = Workout::today()->get();

进阶：同时加载关联的Week数据 #

如果不仅要获取Workout，还要同时加载今天对应的Week关联，可以结合with和wherePivot使用：

$todayWorkouts = Workout::with(['weeks' => function ($query) {
    $query->wherePivot('date', Carbon::today()->toDateString());
}])->today()->get();

常见错误排查 #

• 漏加withPivot('date')：这会导致pivot对象里没有date字段，调用wherePivot('date', ...)时必然报错找不到列。
• 直接在Workout主查询里用wherePivot：wherePivot是关联查询方法，只能用在$workout->weeks()这类关联查询链上，不能直接用在Workout::query()->wherePivot(...)中。

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