Laravel 中 distinct() 方法的正确使用方式详解-php教程-PHP中文网

Laravel 中 distinct() 方法的正确使用方式详解

本文详解 Laravel Eloquent 中 distinct() 方法在结合 get() 与聚合函数（如 count()）时的行为差异，明确其仅对 SELECT 字段生效、不支持参数化字段去重，并提供正确写法与实战注意事项。

本文详解 laravel eloquent 中 `distinct()` 方法在结合 `get()` 与聚合函数（如 `count()`）时的行为差异，明确其仅对 select 字段生效、不支持参数化字段去重，并提供正确写法与实战注意事项。

在 Laravel 中，distinct() 是一个常被误解的查询构建器方法。它并非按指定字段去重（如 distinct('product_id')），而是作用于整个 SELECT 列表——即对所有选中的列组合进行去重。因此，像 ->distinct('product_id') 这样的写法在 Laravel 10+ 中已被废弃，在早期版本中也无效，Eloquent 会忽略该参数并执行全行去重。

你遇到的问题正源于此：

OrderItem::whereIn('order_id', $customers_id)->distinct('product_id')->get();

这段代码实际等价于：

OrderItem::whereIn('order_id', $customers_id)->distinct()->get();

即对 OrderItem 表中所有被 SELECT *（默认）返回的字段组合去重——只要任意字段不同，整行就被视为唯一，因此结果未按 product_id 归并，看起来“没去重”。

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

✅ 正确做法分两种场景：

① 统计去重数量（推荐）
若只需统计不同 product_id 的个数，应使用 count() 并显式指定字段（注意拼写修正）：

$customers = OrderItem::whereIn('order_id', $customers_id)
    ->distinct()
    ->count('product_id'); // ✅ 正确：count() 支持字段参数，distinct() 保证该字段唯一性

⚠️ 注意：原答案中 'producr_id' 为拼写错误，应为 'product_id'。

② 获取去重后的完整记录（需明确业务语义）
若需获取每个 product_id 对应的一条 OrderItem 记录（例如最新/最早一条），不能依赖 distinct()，而应使用 groupBy 或窗口函数：

// 方案一：按 product_id 分组，取每组 id 最小的记录
$items = OrderItem::whereIn('order_id', $customers_id)
    ->selectRaw('MIN(id) as id, product_id, ...') // 显式选择所需字段
    ->groupBy('product_id')
    ->get();

// 方案二：Laravel 9+ 支持 subquery + ROW_NUMBER()（更灵活）
$items = OrderItem::whereIn('order_id', $customers_id)
    ->select('*')
    ->from(DB::raw("(SELECT *, ROW_NUMBER() OVER (PARTITION BY product_id ORDER BY created_at DESC) AS rn FROM order_items) AS ordered"))
    ->where('rn', 1)
    ->get();

? 关键总结：