
本文详解如何在 Laravel 中通过 Eloquent 预加载(eager loading)结合聚合查询,为多个用户统一获取按天分组的统计数据(如 min_level、max_level、sum_level_change),并解决因 groupBy 导致预加载返回空数组的常见问题。
本文详解如何在 laravel 中通过 eloquent 预加载(eager loading)结合聚合查询,为多个用户统一获取按天分组的统计数据(如 min_level、max_level、sum_level_change),并解决因 `groupby` 导致预加载返回空数组的常见问题。
在 Laravel 中,当需要为单个用户获取最近 7 天按日聚合的统计信息(例如等级变化极值与总和)时,使用 selectRaw() + groupByRaw('DAY(date)') 是可行的;但直接将其迁移到多用户场景(如 $room->users()->with('statistics', ...))时,常会遇到 statistics 关系始终返回空数组的问题——根本原因在于:Eloquent 的 with() 预加载不支持对聚合查询结果进行一对一/一对多关联映射,因为 GROUP BY 后的结果不再与原始关系表的主键一一对应,Laravel 无法自动绑定。
✅ 正确解法是:使用带闭包约束的 with() 语法(Laravel 8+ 推荐写法),并确保聚合查询逻辑完整且字段可被关联识别。但需特别注意两点:
-
groupBy字段必须与selectRaw中的别名一致,且需保证分组维度能被 ORM 理解; -
聚合结果无法直接通过
with()绑定到模型属性(如$user->statistics),而应改用withCount()或更灵活的join+select方式实现“扁平化”统计。
不过,若坚持复用原有结构,以下是最小侵入式修正方案(兼容 Laravel 9.x):
return $room->users()
->with([
'statistics' => function ($query) {
$query->selectRaw('user_id, DAY(created_at) as day, MIN(level) as min_level, MAX(level) as max_level, SUM(level_change) as sum_level_change')
->whereDate('created_at', '>=', now()->subDays(7))
->groupBy('user_id', 'day') // ✅ 必须包含 user_id 以维持关联上下文
->orderBy('sum_level_change', 'desc'); // 按 sum_level_change 降序
}
])
->limit(25)
->get();
⚠️ 关键说明:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
-
user_id必须显式SELECT并加入GROUP BY,否则 Laravel 无法将聚合行匹配回对应用户; -
DAY(created_at)仅适用于 MySQL;若需跨数据库兼容,请改用DATE(created_at); - 返回的
$user->statistics将是一个Collection,每项含user_id,day,min_level等字段,不是单条记录,而是该用户每日的聚合结果集。
? 进阶建议:若目标是「每个用户只取其最高 sum_level_change 对应的那条统计」,应改用子查询或 Window Function(Laravel 10+ 支持);若只需全局排序(如所有用户中 sum_level_change 最高的前 N 条),则推荐使用 join 替代 with:
$stats = DB::table('statistics')
->select('user_id', DB::raw('DATE(created_at) as date'),
DB::raw('MIN(level) as min_level'),
DB::raw('MAX(level) as max_level'),
DB::raw('SUM(level_change) as sum_level_change'))
->whereDate('created_at', '>=', now()->subDays(7))
->groupBy('user_id', 'date')
->orderByDesc('sum_level_change');
return User::joinSub($stats, 'stats', function ($join) {
$join->on('users.id', '=', 'stats.user_id');
})
->select('users.*', 'stats.*')
->limit(25)
->get();
总结:多用户聚合统计的核心在于明确「关联键」与「分组维度」的一致性。避免在 with() 中使用无 user_id 参与的 GROUP BY,优先保障数据可追溯性;复杂排序与筛选场景下,joinSub 或原生查询往往比嵌套 with 更可控、高效。










