17370845950

本文介绍如何在 laravel 中通过关联查询，仅统计已“发货”（delivered）状态订单中的商品销量，并获取销量前三的商品列表。

在构建电商后台仪表盘时，常需展示“最畅销商品”，但若直接对 order_details 表聚合统计（如 SUM(quantity)），会忽略订单实际履约状态——例如，待支付、已取消或未发货的订单不应计入真实销售表现。因此，必须将 order_details 与关联的 orders 表进行条件联查，仅纳入 order_status = 'delivered' 的订单数据。

✅ 正确实现方式（基于 Eloquent 关系）

假设你的 OrderDetails 模型已正确定义了与 Order 模型的关联（例如 belongsTo(Order::class, 'order_id')），且 Order 模型中 status 字段存储订单状态（值为 'delivered' 等字符串），则可使用 whereHas() 方法高效完成筛选：

$top_sell_items = OrderDetails::with(['product', 'order']) // 预加载 product 和关联 order（推荐使用更语义化的 'order' 而非 'orders'）
    ->whereHas('order', function ($query) {
        $query->where('status', 'delivered');
    })
    ->select('product_id', DB::raw('SUM(quantity) as total_quantity'))
    ->groupBy('product_id')
    ->orderBy('total_quantity', 'desc')
    ->take(3)
    ->get();

? 关键点说明： whereHas('order', ...) 确保仅选取所属订单状态为 'delivered' 的明细记录； with(['product', 'order']) 支持后续访问 $item->product->name 或 $item->order->created_at 等字段，提升可扩展性； 列别名建议使用 total_quantity 替代 count，避免与 Eloquent 的 count() 方法语义混淆。

⚠️ 注意事项

• 关系命名一致性：确保 OrderDetails 模型中定义的关联方法名为 order()（单数，返回 belongsTo），而非 orders()（复数易引发误解）。若当前为 orders()，请先修正模型：

  // 在 OrderDetails.php 中
  public function order()
  {
      return $this->belongsTo(Order::class, 'order_id');
  }

• 数据库索引优化：为提升查询性能，建议在 orders.status 和 order_details.order_id 字段上建立联合索引：

  CREATE INDEX idx_orders_status_order_id ON orders(status, id);

• 空结果处理：若无已发货订单，$top_sell_items 将为空集合，前端应做容错渲染（如显示“暂无已发货商品”）。

✅ 最终效果

执行后，$top_sell_items 将是一个包含 3 条 OrderDetails 实例的集合，每条均携带：

• product_id（商品 ID）
• total_quantity（该商品在所有已发货订单中的总销量）
• product（预加载的完整 Product 模型）

你可轻松在 Blade 模板中遍历展示：

@foreach($top_sell_items as $item)
    {{ $item->product->name }} — {{ $item->total_quantity }} 件
@endforeach

此方案兼顾可读性、性能与 Laravel 最佳实践，是处理跨表状态过滤聚合统计的标准解法。