本文详解如何利用 Laravel 集合（Collection）与嵌套 sum() 方法，对 PostgreSQL 的 JSONB 字段（如 data->body->aaa 等）进行跨记录、按客户分组的多字段数值求和，避免手动遍历与重复 JSON 解析，提升报表生成性能。
本文详解如何利用 laravel 集合（collection）与嵌套 `sum()` 方法，对 postgresql 的 jsonb 字段（如 `data->body->aaa` 等）进行跨记录、按客户分组的多字段数值求和，避免手动遍历与重复 json 解析，提升报表生成性能。
在 Laravel 应用中，当业务需定期汇总客户月度行为数据（如每周存一条 JSONB 记录），且关键指标以嵌套结构存储于 data 字段（例如 {"body": {"aaa": 22, "bbb": 22, ...}}）时，直接使用 Eloquent 或原生 SQL 聚合 JSONB 内部值会面临语法复杂、可读性差、难以维护等问题。此时，Laravel 的 集合驱动聚合 是更优雅、可控且符合框架哲学的解决方案。
✅ 核心思路：分层聚合 + 匿名函数提取
不依赖数据库层解析 JSONB（如 jsonb_extract_path_text），而是将查询结果转为 Collection，利用 where() 筛选目标客户，再通过高阶 sum() 方法配合闭包，逐条提取并累加 body 下所有数值字段：
// 假设 $reports 是已查询出的本月全部记录集合（Eloquent Collection）
$customerId = 25;
$customerReports = $reports->where('customer_id', $customerId);
$totalSum = $customerReports->sum(function ($report) {
// 安全解析 JSONB 字段，推荐使用 optional() 防止空值异常
$body = optional(json_decode($report->data))->body ?? new \stdClass();
return collect((array) $body)->sum(); // 对 body 所有属性值求和
});? 提示：若需分别统计各字段（如 aaa_sum, bbb_sum），可改用 reduce()：
$sums = $customerReports->reduce(function ($carry, $report) { $body = optional(json_decode($report->data))->body ?? new \stdClass(); $carry['aaa'] += $body->aaa ?? 0; $carry['bbb'] += $body->bbb ?? 0; $carry['ccc'] += $body->ccc ?? 0; $carry['ddd'] += $body->ddd ?? 0; return $carry; }, ['aaa' => 0, 'bbb' => 0, 'ccc' => 0, 'ddd' => 0]); // 结果：['aaa' => 22, 'bbb' => 120, ...]
⚠️ 关键注意事项
- 性能考量：该方案适用于单次处理量适中（如数千条记录）。若数据量极大（>10万），建议结合数据库层预聚合（如 LATERAL JOIN + jsonb_each_text）或迁移到物化视图。
- JSON 安全性：务必使用 optional() 或 ?? 处理可能的 null/缺失字段，避免 Trying to get property 'xxx' of non-object 错误。
- 字符编码：确保 data 字段内容为 UTF-8 编码，json_decode() 才能正确解析中文键名（如有）。
- 批量写入优化：汇总后插入新表时，应使用 Model::upsert() 或 DB::table()->insert() 批量操作，而非循环 save()。
✅ 最佳实践：封装为可复用方法
将逻辑抽象为模型作用域或服务类方法，提升可测试性与复用性：
// 在 SummaryReport 模型中
public function scopeSumBodyFields($query, $customerId, array $keys = ['aaa', 'bbb', 'ccc', 'ddd']) {
return $query->where('customer_id', $customerId)
->get()
->reduce(function ($sums, $report) use ($keys) {
$body = optional(json_decode($report->data))->body ?? new \stdClass();
foreach ($keys as $key) {
$sums[$key] = ($sums[$key] ?? 0) + ($body->$key ?? 0);
}
return $sums;
}, []);
}
// 调用：SummaryReport::sumBodyFields(25)->toArray();通过集合驱动的声明式聚合，你既能保持代码简洁专业，又能精准控制数据流与错误边界——这正是 Laravel “优雅务实”哲学在数据处理场景下的典型体现。
