本文介绍如何使用 laravel 的 query builder 对商品表与入库记录表进行关联查询，并正确聚合计算每个商品的总入库金额，解决因缺少 group by 导致的重复行与 null 值问题。
在实际开发中，我们常需统计某类实体（如商品）与其关联记录（如入库单、销售单）的聚合数据。本例中，products 表存储商品基本信息，ins 表记录每次入库的金额及对应商品 ID。目标是：按商品名称分组，汇总其所有入库金额（SUM(ins.amount)），而非返回每条明细记录。
你当前的查询存在两个关键问题：
- 未使用 GROUP BY：仅用 SUM() 而不配合分组，会导致 SQL 语义错误（MySQL 5.7+ 严格模式下直接报错），或返回不可预测的单行结果；
- 未处理 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}
]
这正是预期的「商品名 + 总金额」格式，简洁、准确、可直接用于前端展示或报表生成。