在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属性。
注意事项：
- 如果您需要获取多个列的唯一组合，可以在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数据库查询。
