17370845950

本文介绍如何使用 laravel 的 query builder 对商品表与入库记录表进行关联查询，并正确聚合计算每个商品的总入库金额，解决因缺少 group by 导致的重复行与 null 值问题。

在实际开发中，我们常需统计某类实体（如商品）与其关联记录（如入库单、销售单）的聚合数据。本例中，products 表存储商品基本信息，ins 表记录每次入库的金额及对应商品 ID。目标是：按商品名称分组，汇总其所有入库金额（SUM(ins.amount)），而非返回每

你当前的查询存在两个关键问题：

1. 未使用 GROUP BY：仅用 SUM() 而不配合分组，会导致 SQL 语义错误（MySQL 5.7+ 严格模式下直接报错），或返回不可预测的单行结果；
2. 未处理 NULL 值：ins.amount 可能为 NULL（如外键匹配失败或字段允许空值），SUM() 会自动忽略 NULL，但若某商品所有 amount 均为 NULL，则 total 将为 NULL，需显式处理。

✅ 正确做法如下（Laravel 9+ 风格）：

public function index()
{
    $productTotals = DB::table('products')
        ->leftJoin('ins', 'products.id', '=', 'ins.products_id') // 改用 leftJoin 保证无入库记录的商品也能显示（total=0）
        ->select('products.name', DB::raw('COALESCE(SUM(ins.amount), 0) as total'))
        ->groupBy('products.id', 'products.name') // 必须按主键和非聚合字段分组
        ->get();

    return response()->json($productTotals);
}

? 关键说明：

• 使用 leftJoin 替代 join，确保即使某商品在 ins 表中无任何记录，仍会出现在结果中（total 为 0）；
• COALESCE(SUM(...), 0) 将 NULL 总和转为 0，提升结果可读性；
• groupBy('products.id', 'products.name') 是必需的：既保证分组唯一性（ID 主键），又满足 SELECT 中非聚合字段的要求（避免 SQL 错误）；
• 若需排除 amount 为 NULL 的记录，可在 WHERE 中添加条件：->whereNotNull('ins.amount')。

? 补充建议：

• 数据库层面应在 ins.products_id 上建立外键与索引，提升 JOIN 性能；
• 若业务中存在多币种或精度敏感场景，建议将 amount 字段设为 DECIMAL(10,2) 并在 PHP 中使用 bcadd() 等函数做精确运算；
• 生产环境应避免直接 echo $product，改用 response()->json() 或资源类（Resource）进行标准化输出。

执行后，你将获得结构清晰的聚合结果：

[
  {"name": "Aerobat", "total": 70},
  {"name": "god of war", "total": 30},
  {"name": "Rs537", "total": 0}
]

这正是预期的「商品名 + 总金额」格式，简洁、准确、可直接用于前端展示或报表生成。