本文详解如何使用 Laravel 集合（Collection）结合闭包与嵌套 sum，对 PostgreSQL 的 JSONB 字段（如 data->body->aaa 等）中多个数值键进行动态聚合求和，并安全写入汇总表。
本文详解如何使用 laravel 集合（collection）结合闭包与嵌套 sum，对 postgresql 的 jsonb 字段（如 `data->body->aaa` 等）中多个数值键进行动态聚合求和，并安全写入汇总表。
在 Laravel 应用中处理 JSONB 类型数据时，常见场景是：每月为每位客户生成多条含结构化指标的记录（如 body.aaa, body.bbb），月末需按客户 ID 汇总所有指标的总和，用于生成报表或写入汇总表。由于数据存储在 JSONB 字段中（如 data 列），直接使用 SQL SUM() 无法跨键灵活聚合，此时借助 Laravel Collection 的链式操作可实现清晰、可维护的解决方案。
✅ 推荐做法：使用 Collection + 闭包嵌套 sum
核心思路是：先按 customer_id 分组筛选原始记录 → 将每组记录解码为 PHP 对象 → 遍历其 data->body 子对象 → 对所有数值字段执行内层 sum()。代码简洁且不依赖数据库函数，兼容性高：
// 假设 $reports 是从数据库查询出的原始记录集合（Eloquent Collection）
$reports = SummaryReport::where('created_at', '>=', now()->startOfMonth())->get();
// 按 customer_id 分组并计算各客户指标总和
$summaryByCustomer = $reports
->groupBy('customer_id')
->map(function ($group, $customerId) {
// 提取所有 body 对象，并确保为数组/对象（避免 null 或格式异常）
$bodies = $group->map(function ($item) {
$body = data_get(json_decode($item->data, true), 'body');
return is_array($body) ? $body : [];
});
// 对每个 body 中所有数值字段求和（自动跳过非数字值）
$total = $bodies->reduce(function ($carry, $body) {
return $carry + collect($body)->sum(function ($value) {
return is_numeric($value) ? (float) $value : 0;
});
}, 0);
return [
'customer_id' => $customerId,
'total_sum' => $total,
// 可扩展：分别统计各字段（见下方进阶示例）
];
});
// 批量插入汇总表（推荐使用 upsert 或 chunk 防止内存溢出）
SummaryMonthly::upsert(
$summaryByCustomer->values()->all(),
['customer_id'],
['total_sum', 'updated_at']
);⚠️ 关键注意事项
- JSON 解析健壮性：始终使用 json_decode($str, true)（返回关联数组）配合 data_get()，比对象访问（->body->aaa）更安全，可规避 null 或缺失键导致的 Trying to get property ... 错误。
- 性能考量：若单月记录量极大（如 >10,000 条），建议改用数据库原生 JSONB 聚合（如 SUM((data->'body'->>'aaa')::numeric)），并在 data->body 上添加 GIN 索引；Collection 方案适用于中等规模（<5k 条/客户）且逻辑复杂的场景。
- 字段级精确汇总（进阶）：若需分别汇总 aaa, bbb, ccc, ddd，可改用 mapWithKeys：
$perFieldSum = $bodies->reduce(function ($carry, $body) {
foreach (['aaa', 'bbb', 'ccc', 'ddd'] as $key) {
$carry[$key] = ($carry[$key] ?? 0) + (float) ($body[$key] ?? 0);
}
return $carry;
}, []);
// 结果：['aaa' => 22, 'bbb' => 120, ...]✅ 总结
Laravel Collection 并非仅用于简单数组处理——通过 groupBy、map、reduce 与嵌套 sum() 的组合，可优雅应对 JSONB 中多层级、多键值的聚合需求。相比硬编码字段名或拼接 SQL，该方案更具可读性、可测试性与可扩展性。实际部署前，请务必在生产数据子集上验证内存占用与执行时间，并根据数据规模选择 Collection（应用层）或原生 JSONB 函数（数据库层）作为主方案。
