Laravel Eloquent 如何对同一关系进行两次不同约束的延迟预加载

你遇到的问题很常见——当你想对同一个关联关系应用不同的约束条件进行预加载时，直接多次调用with('punches')会导致后面的约束覆盖前面的，因为Eloquent默认会合并同一关系的查询条件。下面提供两种可行的解决方案，你可以根据自己的需求选择：

方法一：在模型中定义专用关联方法（推荐） #

最清晰且可复用的方式是在Timesheet模型中为这两个需求分别定义独立的关联方法：

// app/Models/Timesheet.php
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use Carbon\Carbon;

class Timesheet extends Model
{
    // 基础的 punches 关联
    public function punches(): HasMany
    {
        return $this->hasMany(Punch::class);
    }

    // 过去一年的工时记录
    public function punchesPastYear(): HasMany
    {
        return $this->punches()->where('punch_date', '>=', Carbon::now()->subYear());
    }

    // 首次工作的打卡记录（取最早的一条）
    public function firstPunch(): HasOne
    {
        return $this->hasOne(Punch::class)->oldest('punch_date');
    }
}

然后在查询时直接预加载这两个关联：

$employeeTimeSheets = Timesheet::with(['punchesPastYear', 'firstPunch'])->get();

使用这种方式，你可以在任何地方复用这些关联逻辑，而且代码可读性非常高。之后访问数据时也很直观：

// 获取某员工过去一年的工时
$pastYearPunches = $employeeTimeSheets->first()->punchesPastYear;

// 获取某员工的首次工作日期
$firstWorkDate = $employeeTimeSheets->first()->firstPunch->punch_date;

方法二：直接在查询中使用别名（无需修改模型） #

如果你不想在模型中新增方法，可以直接在with方法中使用自定义别名，并在闭包里编写关联查询逻辑：

use Carbon\Carbon;
use App\Models\Timesheet;

$employeeTimeSheets = Timesheet::with([
    // 别名：punches_past_year，对应过去一年的工时
    'punches_past_year' => function ($query) {
        $query->select('id', 'timesheet_id', 'punch_date', /* 按需添加其他字段 */)
              ->whereColumn('timesheet_id', 'timesheets.id')
              ->where('punch_date', '>=', Carbon::now()->subYear());
    },
    // 别名：first_punch，对应首次工作日期
    'first_punch' => function ($query) {
        $query->select('id', 'timesheet_id', 'punch_date')
              ->whereColumn('timesheet_id', 'timesheets.id')
              ->orderBy('punch_date', 'asc')
              ->limit(1);
    }
])->get();

这种方式不需要修改模型，但逻辑只在当前查询中可用，适合一次性的需求。

额外优化：直接在主查询中获取首次工作日期 #

如果你的需求只是获取首次工作日期，而不需要完整的打卡记录，还可以通过子查询直接在主查询中添加这个字段，避免额外的预加载查询，提升效率：

use Carbon\Carbon;
use App\Models\Timesheet;
use App\Models\Punch;

$employeeTimeSheets = Timesheet::with([
    'punches' => function ($query) {
        $query->where('punch_date', '>=', Carbon::now()->subYear());
    }
])->addSelect([
    'first_work_date' => Punch::select('punch_date')
        ->whereColumn('timesheet_id', 'timesheets.id')
        ->oldest()
        ->limit(1)
])->get();

这样每个Timesheet实例会直接带有first_work_date属性，无需再通过关联访问：

$firstWorkDate = $employeeTimeSheets->first()->first_work_date;

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