如何在Laravel关联中实现SUM()？解决groupBy调用报错问题

一、搞定「Call to a member function groupBy() on integer」报错 #

这个报错的原因其实很直观：你在查询链里先调用了sum()这类聚合函数，它会立刻执行SQL并返回一个整数结果，而不是继续返回查询构建器实例。后续再调用groupBy()时，自然会因为“整数没有这个方法”而报错。

举个你可能踩坑的错误写法：

// ❌ 错误：sum()返回整数，无法链式调用groupBy()
$wrongResult = YourModel::sum('amount')->groupBy('category');

正确的思路是先定义分组逻辑，再把聚合计算放进查询里，比如用DB::raw配合select来构建：

// ✅ 正确：先分组，再计算每组的总和
$results = YourModel::select(
    'category',
    DB::raw('SUM(amount) as total_amount')
)
->groupBy('category')
->get();

这样返回的是包含分组字段和对应总和的集合，你可以直接遍历使用。

二、Laravel关联中实现SUM()功能 #

根据你的关联类型（比如hasMany、belongsToMany），有几种实用的实现方式：

1. 用Laravel内置的withSum方法（推荐，Laravel 8+支持） #

如果是一对多关联（比如Order关联多个OrderItem），withSum能帮你预加载关联模型的字段总和，还能避免N+1查询：

// 基础用法：计算每个订单的商品数量总和
$orders = Order::withSum('items', 'quantity')->get();

// 访问总和：字段名格式是「关联名_sum_字段名」
foreach ($orders as $order) {
    echo "订单{$order->id}的总商品数：{$order->items_sum_quantity}";
}

// 进阶：自定义别名 + 条件过滤
$orders = Order::withSum(
    ['items as completed_total' => function ($query) {
        // 只统计已完成的商品
        $query->where('status', 'completed');
    }],
    'quantity'
)->get();

// 访问自定义别名的总和
foreach ($orders as $order) {
    echo "订单{$order->id}已完成商品数：{$order->completed_total}";
}

2. 手动关联查询 + 聚合函数 #

如果需要更复杂的逻辑（比如多表关联过滤），可以用join结合DB::raw实现：

$orders = Order::select(
    'orders.*',
    DB::raw('SUM(order_items.quantity) as total_quantity')
)
->leftJoin('order_items', 'orders.id', '=', 'order_items.order_id')
->where('order_items.status', 'completed')
->groupBy('orders.id')
->get();

3. 在模型中定义方法（适合单个模型查询） #

如果只是查询单个模型的关联总和，可以在模型里写个方法：

// 在Order模型中
public function totalQuantity()
{
    // 直接调用关联的sum方法
    return $this->items()->sum('quantity');
}

// 使用时
$order = Order::find(1);
echo "该订单总商品数：{$order->totalQuantity()}";

⚠️ 注意：这种方式批量查询多个模型会触发N+1查询问题，批量场景优先用withSum或join。

内容的提问来源于stack exchange，提问作者stack