本文详解如何利用 Laravel 的集合（Collection）方法，高效、安全地对 PostgreSQL JSONB 类型字段中嵌套的多个键值（如 aaa、bbb 等）执行跨记录求和运算，并适配定时任务场景。
本文详解如何利用 laravel 的集合（collection）方法，高效、安全地对 postgresql jsonb 类型字段中嵌套的多个键值（如 `aaa`、`bbb` 等）执行跨记录求和运算，并适配定时任务场景。
在 Laravel 应用中，当使用 PostgreSQL 的 jsonb 字段持久化结构化数据（如每月多条客户指标快照）时，常见的需求是：按客户聚合其所有历史记录中 JSON 内部各字段的数值总和（例如 body.aaa + body.bbb + body.ccc + body.ddd），用于生成月度汇总报表。
直接使用 Eloquent 查询或原生 SQL 对 JSONB 多层嵌套字段逐键求和虽可行，但代码冗长、可维护性差，且难以动态扩展。更优雅的方式是结合 Laravel 集合的链式操作能力，在内存中完成结构解析与聚合——前提是数据量可控（如单客户月度 4 条，总量合理）。
✅ 推荐实现方案：Collection 链式聚合
假设你的模型为 SummaryReport，表结构含 customer_id: integer 和 data: jsonb，其中 data 存储形如 {"body": {"aaa": 22, "bbb": 22, "ccc": 22, "ddd": 12}} 的 JSON。
以下代码片段展示了如何为指定客户 ID 计算其所有记录中 body 下全部数值字段的总和：
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
$customerId = 25;
// 1. 获取该客户的全部原始报告记录（Eloquent Collection）
$reports = SummaryReport::where('customer_id', $customerId)->get();
// 2. 使用 Collection 方法链式处理：
$totalSum = $reports->map(function ($report) {
// 安全解析 data 字段，提取 body 对象
$body = data_get(json_decode($report->data, associative: true), 'body', []);
// 将 body 中所有数值（自动过滤非数字）求和
return array_sum(array_filter($body, 'is_numeric'));
})->sum(); // 外层 sum 汇总所有记录的 body 总和
// ✅ $totalSum 即为客户 25 当前所有记录中 body 所有字段的数值总和? 关键点说明：
- data_get(..., 'body', []) 替代 json_decode(...)->body，避免因字段缺失导致的 Trying to get property 'body' of non-object 错误；
- array_filter($body, 'is_numeric') 自动跳过 null、字符串等非数值项，增强健壮性；
- map() + sum() 组合清晰分离「单条记录内求和」与「多条记录间求和」逻辑，语义明确、易于调试。
? 进阶：按字段分别汇总（如需 aaa_total、bbb_total）
若需生成分字段统计（而非单一总和），可改用 reduce() 或 groupBy 后聚合：
$fieldSums = $reports->reduce(function ($carry, $report) {
$body = data_get(json_decode($report->data, associative: true), 'body', []);
foreach (['aaa', 'bbb', 'ccc', 'ddd'] as $key) {
$carry[$key] = ($carry[$key] ?? 0) + ($body[$key] ?? 0);
}
return $carry;
}, []);
// 结果示例：['aaa' => 22, 'bbb' => 120, 'ccc' => 22, 'ddd' => 13]⚠️ 注意事项与最佳实践
- 性能边界：本方案适用于单次处理数百至数千条记录。若需处理海量数据（如全量客户月报），建议改用 PostgreSQL 原生 JSONB 函数（如 jsonb_path_query_sum() 或 SUM((data->'body'->>'aaa')::numeric)）在数据库层完成聚合，避免内存压力。
- JSON 结构一致性：确保 data->body 结构稳定。可在模型中添加访问器（accessor）统一校验/标准化输入。
- 空值与类型安全：始终使用 ?? 0 或 data_get(..., $key, 0) 防止 null 参与计算；对关键业务字段建议增加数据库约束（如 CHECK ((data->'body'->>'aaa') ~ '^[0-9]+$')）。
- 定时任务集成：在 Artisan 命令中封装上述逻辑，配合 chunkById() 分批处理，防止超时：
SummaryReport::query()
->select('customer_id')
->distinct()
->chunkById(100, function ($chunks) {
foreach ($chunks as $chunk) {
$this->processCustomerMonthlySummary($chunk->customer_id);
}
});通过合理运用 Laravel 集合的函数式编程能力，你无需编写复杂 SQL 即可灵活应对 JSONB 动态结构的聚合需求，让报表逻辑更专注业务，而非数据搬运。
