
本文介绍使用 Laravel 的 latestOfMany() 方法,结合 whereHas 精确查询一对多关系中“最新一条子记录”满足特定条件的父模型数量,并补充处理无关联记录的场景。
本文介绍使用 laravel 的 `latestofmany()` 方法,结合 `wherehas` 精确查询一对多关系中“最新一条子记录”满足特定条件的父模型数量,并补充处理无关联记录的场景。
在 Laravel 开发中,常需基于一对多关系(如 Item → Histories)进行条件统计,但一个常见误区是:直接使用 whereHas 会匹配任意一条满足条件的子记录,而非最新的一条。例如,你想统计「最新操作状态为 good」的物品数量,若某物品历史记录为 [broken, good, broken],其最新状态实为 broken,但传统 whereHas 可能因中间的 good 记录而错误计入。
✅ 正确方案:使用 latestOfMany()
Laravel 9.x+ 引入了 latestOfMany() 关系方法,专为解决“一对多中取最新一条”这一高频需求。它会在数据库层面通过子查询或窗口函数(取决于数据库驱动)精确获取每条父记录对应的最新子记录。
首先,在 Item 模型中定义正确的关系:
// app/Models/Item.php
public function histories()
{
return $this->hasMany(History::class);
}
// ✅ 关键:使用 latestOfMany() 替代 latest()
public function latestHistory()
{
return $this->hasOne(History::class)->latestOfMany();
}
⚠️ 注意:latestOfMany() 默认按 created_at 降序取最新;若需按自定义字段(如你的 date 字段)排序,请显式指定:
return $this->hasOne(History::class)->latestOfMany('date');
接着,在控制器中使用 whereHas 查询最新状态:
// app/Http/Controllers/MyController.php
$items_status = [];
$items_status['good'] = Item::whereHas('latestHistory', fn ($q) => $q->where('status', 'good'))->count();
$items_status['broken'] = Item::whereHas('latestHistory', fn ($q) => $q->where('status', 'broken'))->count();
// ✅ 补充:统计无任何历史记录的物品(推荐用 doesntHave)
$items_status['no_history'] = Item::doesntHave('histories')->count();
dd($items_status);
// 示例输出:['good' => 12, 'broken' => 8, 'no_history' => 5]
? 原理说明与性能提示
- latestOfMany() 在底层生成高效 SQL(如 PostgreSQL 的 DISTINCT ON 或 MySQL 8.0+ 的 ROW_NUMBER() 窗口函数),避免 N+1 查询和内存过滤。
- whereHas('latestHistory', ...) 会自动将 latestHistory 关系的子查询作为关联条件,确保只匹配“最新那条”的 status。
- 不要混用 with('latestHistory') 与 whereHas 统计场景——with 仅用于预加载,对 count() 无实际影响,反而增加开销。
? 扩展:支持多条件 & 排除空值
若 date 字段可能为 NULL,建议在迁移中添加约束,或在关系中排除无效记录:
public function latestHistory()
{
return $this->hasOne(History::class)
->whereNotNull('date')
->latestOfMany('date');
}
✅ 总结
| 场景 | 推荐方法 | 说明 |
|---|---|---|
| 统计最新子记录满足某状态的父模型数 | whereHas('latestHistory', ...) + latestOfMany() | 精准、高效、声明式 |
| 统计无任何子记录的父模型数 | doesntHave('histories') | 语义清晰,底层为 NOT EXISTS |
| 需按非时间字段取“最新” | latestOfMany('custom_column') | 支持任意可排序字段 |
通过 latestOfMany(),你不再需要手写复杂子查询或在 PHP 层遍历判断,即可在一行代码中实现业务上真正严谨的“最新状态统计”。











