本文介绍如何使用 laravel spatie query builder 实现基于关联模型（如 `examinations`）**最新一条记录**（而非任意记录）的精准过滤，解决 `wherehas` 无法限制“最后一条”的常见误区。
在使用 Spatie Query Builder 进行关系过滤时，一个典型误区是误以为 whereHas(...-youjiankuohaophpcnorderBy()->limit(1)) 能筛选出“拥有最新检查且患病”的动物——但实际上，whereHas 中的 orderBy 和 limit 在子查询中被忽略（Eloquent 不支持在 whereHas 子查询中使用排序与分页），导致它仍会匹配任意一条满足条件的检查记录，而非严格意义上的“最后一次”。
要真正实现“仅当最新一次检查的 disease_id 非空时才视为生病”，需采用两阶段查询策略：先定位每只动物的最新检查记录 ID，再基于这些 ID 精确过滤。
以下是推荐的、高效且可读性强的实现方式（已适配 Laravel 9+ 及 Spatie Query Builder v5+）：
<?php
use App\Models\Examination;
use Spatie\QueryBuilder\Filters\Filter;
use Illuminate\Database\Eloquent\Builder;
class SickAnimalsFilter implements Filter
{
public function __invoke(Builder $query, $value, string $property)
{
// Step 1: 获取每只动物最新 examination 的 id（利用 withMax 关联聚合）
$query->select('animals.*'); // 显式选择主表字段，避免后续 pluck 异常
$animalIdsWithLatestExam = $query
->withMax('examinations', 'id')
->get()
->filter(fn ($animal) => $animal->examinations_max_id !== null)
->pluck('examinations_max_id');
// Step 2: 查询这些最新 examination ID 对应的记录，并筛选 disease_id != null
$sickAnimalIds = Examination::query()
->whereIn('id', $animalIdsWithLatestExam)
->whereNotNull('disease_id')
->pluck('animal_id');
// Step 3: 主查询仅保留符合条件的 animal.id
$query->whereIn('id', $sickAnimalIds);
}
}✅ 关键说明：
- withMax('examinations', 'id') 利用 Eloquent 的聚合关系，为每个 Animal 附加 examinations_max_id 字段（即其最新检查 ID），无需 N+1 查询，性能优秀；
- filter(...->examinations_max_id !== null) 排除从未做过检查的动物，避免空值干扰；
- whereNotNull('disease_id') 比 != null 更语义清晰且兼容 SQL 标准（尤其在 PostgreSQL 中更可靠）；
- 整个流程逻辑清晰、可测试、易维护，不依赖原始 SQL，保持 Laravel 生态一致性。
⚠️ 注意事项：
- 确保 examinations 表的 animal_id 字段已建立索引（INDEX animal_id），否则 whereIn + 子查询可能影响性能；
- 若数据量极大（>100k 动物），建议将此逻辑移至数据库视图或使用原生 JOIN 优化（例如通过 ROW_NUMBER() OVER (PARTITION BY animal_id ORDER BY created_at DESC)）；
- 此过滤器默认启用，需在控制器中显式注册：
$animals = QueryBuilder::for(Animal::class) ->allowedFilters(Filter::custom('sick', SickAnimalsFilter::class)) ->get();
通过该方案，你将精准获得“当前生病”的动物列表——即其最后一次检查明确关联了疾病，彻底规避历史病历造成的误判。
