本文详解如何利用 Laravel 集合（Collection）方法，对 PostgreSQL 的 JSONB 字段中嵌套的多个键值（如 aaa、bbb 等）进行动态、可扩展的跨记录求和，适用于月度汇总、报表生成等场景。
本文详解如何利用 laravel 集合（collection）方法，对 postgresql 的 jsonb 字段中嵌套的多个键值（如 `aaa`、`bbb` 等）进行动态、可扩展的跨记录求和，适用于月度汇总、报表生成等场景。
在 Laravel 应用中处理 JSONB 类型数据时，常见的挑战是：无法直接通过 Eloquent 或 Query Builder 对 JSON 内部字段执行聚合运算（如 SUM），尤其当结构为多层嵌套（如 data → body → {aaa, bbb, ccc, ddd}）且需按 customer_id 分组汇总时。原代码尝试逐条解码并手动累加，不仅性能差、易出错，也无法优雅支持新增字段或动态键名。
正确的解决思路是：先通过数据库查询精准筛选目标记录，再交由 Laravel Collection 进行内存级结构化解析与聚合——既保持逻辑清晰，又避免 SQL 层面对 JSONB 的复杂路径操作（如 ->'body'->>'aaa' 的硬编码）。
✅ 推荐实现方案（基于 Collection）
假设你的模型为 SummaryReport，表中含 customer_id（INT）和 data（JSONB）字段，且每条记录的 data 结构如下：
{
"body": {
"aaa": 0,
"bbb": 98,
"ccc": 0,
"ddd": 1
}
}以下代码可按 customer_id 分组，计算每个客户所有记录中 body 下所有数值字段的总和：
use Illuminate\Support\Collect;
// 1. 按 customer_id 分组获取原始集合（推荐：使用 chunkById 避免内存溢出）
$reports = SummaryReport::whereBetween('created_at', [$startOfMonth, $endOfMonth])
->get()
->groupBy('customer_id');
// 2. 遍历每组客户数据，计算 body 内所有数值之和
$customerSums = $reports->map(function ($group, $customerId) {
$total = $group->sum(function ($report) {
// 安全解码 JSONB 字段，并提取 body 对象
$body = data_get(json_decode($report->data, true), 'body', []);
// 对 body 中所有数值（自动忽略非数字）求和
return array_sum(array_filter($body, 'is_numeric'));
});
return [
'customer_id' => (int) $customerId,
'total_sum' => (int) $total,
'generated_at'=> now(),
];
})->values();
// 3. 批量写入汇总表（如 summary_monthly_totals）
SummaryMonthlyTotal::upsert($customerSums->all(), ['customer_id'], ['total_sum', 'generated_at']);⚠️ 关键注意事项
-
性能优化：若单月记录数超万条，避免 get() 全量加载。改用 cursorPaginate() 或 chunkById() 分批处理：
SummaryReport::query() ->whereBetween('created_at', [...]) ->chunkById(500, function ($chunk) use (&$aggregated) { $chunk->groupBy('customer_id')->each(...); }); -
健壮性保障：
- 使用 data_get() 替代链式 -> 访问，防止 null 或缺失字段导致 ErrorException；
- array_filter($body, 'is_numeric') 自动跳过字符串、null、布尔值等非数值项；
- 强制类型转换 (int) 防止浮点精度问题（如需保留小数，用 (float)）。
-
扩展性设计：若未来需单独统计各字段（如仅 aaa + bbb），可将求和逻辑抽象为配置：
$targetKeys = ['aaa', 'bbb']; // 动态定义 $sum = collect($body)->only($targetKeys)->filter('is_numeric')->sum();
✅ 总结
Laravel 的 Collection 是处理 JSONB 聚合的“银弹”——它绕开了数据库 JSON 函数的语法限制，以声明式、可测试、易维护的方式完成复杂嵌套求和。核心原则是：数据库负责精准筛选，PHP 层负责结构化解析。配合分批处理与异常防护，该方案可稳定支撑高频率报表任务，且易于适配字段变更与业务演进。
