掌握Laravel查询：Distinct与GroupBy在多表联接中的正确用法-php教程-PHP中文网

掌握Laravel查询：Distinct与GroupBy在多表联接中的正确用法

DDD

发布： 2025-09-12 12:41:24

原创

476人浏览过

掌握Laravel查询：Distinct与GroupBy在多表联接中的正确用法

本文深入探讨了在Laravel中进行多表联接查询时，如何精确地获取期望的唯一ID或唯一记录。针对distinct()方法在无明确select()时的默认行为，文章提供了两种核心解决方案：通过select()与distinct()组合来获取特定列的唯一值，以及利用groupBy()方法获取每组的完整唯一记录，并详细阐述了它们的应用场景与注意事项，旨在帮助开发者避免常见的查询陷阱。

在laravel的数据库查询构建器中，当执行多表联接（join）操作并尝试获取特定列的唯一值时，开发者常会遇到一个常见问题：即使使用了distinct()方法，结果集中的id可能并非预期的目标表id，而是其他联接表的id。这通常是由于distinct()方法的默认行为以及查询构建器隐式选择所有列所导致的。

理解distinct()的默认行为

当您在不明确指定select()的情况下使用distinct()时，Laravel的查询构建器会默认选择所有联接表中的所有列（SELECT *）。在这种情况下，distinct()会作用于整个结果行，这意味着只有当一行中的所有列值都完全相同时，该行才会被视为重复并被排除。如果联接的表中存在其他列的值不同，即使目标ID相同，整行也会被认为是唯一的，从而无法达到获取目标ID唯一值的目的。

例如，原始查询如下：

$objectives = DB::table('objectives')
    ->join('users', 'objectives.assigned_id', '=', 'users.id')
    ->join('media', 'objectives.training_document_id', '=', 'media.model_id')
    ->where('objectives.assigned_id', '=', $assigned_id)
    ->where('media.model_type', '=', 'App\Models\TrainingDoc')
    ->distinct('objectives.id') // 这里的distinct('objectives.id')实际上不会生效
    ->get();

登录后复制

在这个例子中，distinct('objectives.id')并不能如预期般只返回objectives.id的唯一值。因为distinct()如果没有明确的select()语句，它会尝试对所有列进行去重，而传递给distinct()的参数通常会被忽略或误解。

解决方案一：明确指定select()并结合distinct()

要正确获取特定列的唯一值，最直接有效的方法是显式地使用select()方法指定您需要去重的那一列，然后再调用distinct()方法。这样，distinct()将仅作用于您明确选择的列，从而返回该列的唯一值集合。

$objectives = DB::table('objectives')
    ->select('objectives.id') // 明确选择 objectives.id
    ->distinct()             // 对选择的 objectives.id 进行去重
    ->join('users', 'objectives.assigned_id', '=', 'users.id')
    ->join('media', 'objectives.training_document_id', '=', 'media.model_id')
    ->where('objectives.assigned_id', '=', $assigned_id)
    ->where('media.model_type', '=', 'App\Models\TrainingDoc')
    ->get();

登录后复制

通过这种方式，get()方法将返回一个包含唯一objectives.id值的集合。每个集合元素将是一个对象，其中只包含id属性。

注意事项：

飞书多维表格

表格形态的AI工作流搭建工具，支持批量化的AI创作与分析任务，接入DeepSeek R1满血版

查看详情

如果您需要获取多个列的唯一组合，可以在select()中指定多个列，例如 ->select('objectives.id', 'objectives.name')->distinct()。此时，distinct()将对id和name的组合进行去重。
此方法适用于您只需要获取唯一ID列表，而不需要每条记录的完整详细信息的情况。

解决方案二：使用groupBy()获取唯一记录

如果您不仅需要获取唯一的objectives.id，而且希望为每个唯一的objectives.id获取一条完整的记录（例如，该objective的所有相关字段），那么groupBy()方法是一个更合适的选择。groupBy()会将结果集按照指定的列进行分组，并通常返回每个分组的第一条记录（具体行为可能因数据库系统和SQL模式而异，但在Laravel的常见使用场景下，它能有效地达到此目的）。

$objectives = DB::table('objectives')
    ->join('users', 'objectives.assigned_id', '=', 'users.id')
    ->join('media', 'objectives.training_document_id', '=', 'media.model_id')
    ->where('objectives.assigned_id', '=', $assigned_id)
    ->where('media.model_type', '=', 'App\Models\TrainingDoc')
    ->groupBy('objectives.id') // 按照 objectives.id 分组
    ->get();

登录后复制

使用groupBy('objectives.id')后，get()方法将返回一个集合，其中每个元素代表一个唯一的objectives.id所对应的记录。这些记录将包含所有联接表中的列（除非您使用select()明确指定了要返回的列）。

注意事项：

当使用groupBy()时，如果同时选择非分组列且不使用聚合函数（如COUNT(), SUM(), MAX()等），某些数据库（如MySQL在ONLY_FULL_GROUP_BY模式下）可能会报错。在Laravel中，默认情况下通常不会遇到此问题，因为它会选择每个组的第一条记录。
如果您需要对分组后的数据进行聚合计算，可以在select()中添加聚合函数，例如 ->select('objectives.id', DB::raw('COUNT(users.id) as user_count'))。
此方法适用于您需要基于某个ID获取唯一记录的完整数据，或者需要对分组数据进行统计分析的场景。

总结与选择建议

特性/方法	select('column')->distinct()	groupBy('column')
目的	获取指定列的唯一值列表。	获取每个唯一分组的完整记录（或用于聚合统计）。
返回内容	仅包含指定列的唯一值（如 [{id: 1}, {id: 2}]）。	包含所有选择列的完整记录（如 [{id: 1, name: 'A', ...}, {id: 2, name: 'B', ...}]）。
适用场景	仅关心唯一ID本身，例如用于下拉列表选项、ID集合校验等。	需要每条唯一记录的完整数据，或需要对分组数据进行聚合计算。
性能考量	通常更高效，因为只选择和处理少量数据。	可能涉及更多的数据处理，尤其是在选择所有列时。

在实际开发中，根据您的具体需求选择合适的方法至关重要。如果仅仅需要一个唯一ID的列表，select()->distinct()是更简洁高效的选择。而如果需要基于唯一ID获取完整的记录信息，或者进行更复杂的数据聚合，那么groupBy()将是您的首选。理解这两种方法的内在机制和适用场景，将帮助您更精确、高效地构建Laravel数据库查询。

以上就是掌握Laravel查询：Distinct与GroupBy在多表联接中的正确用法的详细内容，更多请关注php中文网其它相关文章！