如何在 Laravel 中按非唯一字段对查询结果进行二维分组

本文介绍如何使用 laravel 的 groupBy() 方法替代 keyBy()，将数据库查询结果按非唯一字段（如 date_scheduled）组织为键值映射的二维数组，避免因键重复导致的数据覆盖问题。

本文介绍如何使用 laravel 的 `groupby()` 方法替代 `keyby()`，将数据库查询结果按非唯一字段（如 `date_scheduled`）组织为键值映射的二维数组，避免因键重复导致的数据覆盖问题。

在 Laravel 开发中，当需要根据某个字段对查询结果进行结构化分组时，开发者常误用 keyBy()。例如，以下代码试图以 date_scheduled 作为键组织项目数据：

$pd = DB::table("projects")     ->orderBy("project_number", "asc")     ->select('name', 'type')     ->get()     ->keyBy('date_scheduled');

⚠️ 问题在于：keyBy() 要求键值唯一；若多个记录具有相同的 date_scheduled（如多项目同日排期），后出现的记录会直接覆盖先前的同键项，造成数据丢失。

✅ 正确解法是使用 groupBy() —— 它专为处理非唯一分组设计，返回一个以指定字段为键、对应集合（Collection）为值的二维结构，每个键下包含所有匹配记录：

$pd = DB::table("projects")     ->orderBy("project_number", "asc")     ->select('name', 'type', 'date_scheduled') // 建议显式包含分组字段便于调试     ->get()     ->groupBy('date_scheduled');

执行后，$pd 将是一个 IlluminateSupportCollection，形如：

IlluminateSupportCollection {#1234   #items: [     "2024-05-10" => IlluminateSupportCollection {#1235       #items: [         (object) ["name" => "Alpha Project", "type" => "Web", "date_scheduled" => "2024-05-10"],         (object) ["name" => "Beta Launch", "type" => "Mobile", "date_scheduled" => "2024-05-10"]       ]     },     "2024-05-15" => IlluminateSupportCollection {#1236       #items: [         (object) ["name" => "Gamma Refactor", "type" => "Backend", "date_scheduled" => "2024-05-15"]       ]     }   ] }

? 关键注意事项：

• groupBy() 返回的是嵌套 Collection，如需转为纯数组，可链式调用 ->map->toArray() 或 ->toArray()（后者对顶层生效，内部仍为对象）；
• 若需进一步提取子集字段（如仅保留 id），可在 groupBy 后使用 map()：

  $pd = DB::table("projects")     ->select('id', 'name', 'date_scheduled')     ->get()     ->groupBy('date_scheduled')     ->map(fn($group) => $group->pluck('id')->values()); // 输出类似问题中的 [0 => 1, 1 => 4, ...]

• 数据库层面分组（如 GROUP BY sql）适用于聚合计算（SUM/count），而本场景属应用层结构重组，应优先使用 Eloquent/Collection 的 groupBy()，语义清晰且兼容性好。

总结：面对非唯一字段的分组需求，请始终选用 groupBy() 而非 keyBy()；它不仅解决覆盖问题，还保持数据完整性与可读性，是 Laravel 数据处理的标准实践。