Laravel JSONB 字段多层数值求和方法

本文深入探讨了在 Laravel 应用中高效、安全地对 PostgreSQL JSONB 字段内嵌套数值（如 `body.aaa`、`body.bbb` 等）进行跨记录求和的实战方案，摒弃冗长 SQL 和脆弱手动解析，转而利用 Laravel 集合的 `map`、`sum`、`reduce` 等链式方法，在内存中完成结构化提取与多层聚合——既保障类型安全与空值容错，又支持灵活扩展（如按字段分别汇总），还无缝适配定时任务分批处理场景；同时明确划清性能边界，指出小数据量用集合优雅处理、大数据量则回归数据库原生 JSONB 函数，真正实现业务逻辑清晰、代码健壮可维护、扩展与性能兼得。

本文详解如何利用 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 动态结构的聚合需求，让报表逻辑更专注业务，而非数据搬运。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Laravel JSONB 字段多层数值求和方法》文章吧，也可关注golang学习网公众号了解相关技术文章。