先get()再groupBy()才能得到按字段归类的子集；数据库groupBy()仅适用于聚合函数，分组后需调用toArray()才能正确JSON响应。
直接用 groupBy() 就行，但必须分清是查完再分组，还是让数据库去分组——这两者结果完全不同，用错就拿不到想要的数据结构。
先 get() 再 groupBy() 才能得到“按字段归类的子集”
这是最常被误解的一点：很多人写 Model::where(...)->groupBy('status')->get()，以为能拿到 status=active、status=inactive 两个数组，实际只得到一堆混在一起的模型，甚至报错。
- 查完再分组才是集合分组：先
get()拿到完整模型集合，再链式调用groupBy('status') - 数据库分组（查询构建器的
groupBy()）只适合配合COUNT、SUM等聚合函数使用，不保留原始记录全量数据 - 如果数据量超 5000 条，别在 PHP 层做
groupBy()，内存和响应时间都会明显上升 - 确认字段真实存在：比如想按
user->profile->role分组，但没with('profile')，那所有项的分组键都是null，最后只剩一个空组
groupBy 参数可以是字符串、闭包或数组
不同参数决定分组逻辑的灵活性和健壮性：
- 字符串如
groupBy('status')：最简单，但要求每个模型都有该属性（含访问器、$appends或已加载关联） - 闭包更可控：
groupBy(fn ($u) => $u->profile?->role ?? 'guest')，避免空值崩掉整个分组 - 数组如
groupBy(['category_id', 'status'])：返回三维嵌套结构，第一层是 category_id，第二层是 status，第三层才是模型集合 - 闭包里别写重逻辑，比如查数据库或调 API，它会在每个模型上执行一次
分组后不能直接 json_encode，必须 toArray()
这是上线后接口返回乱码或前端解析失败的高频原因。
-
$grouped = $users->groupBy('status')返回的是Illuminate\Support\Collection，不是数组 -
json_encode($grouped)会序列化 Collection 对象元信息，前端看到的是带__toString和私有属性的 JSON - 正确做法：
json_encode($grouped->toArray())或链式写->map->toArray()->toArray() - 如果只需要值不要键（比如丢掉 'active'、'inactive' 这些 key），最后补个
->values()
大数据量时优先考虑数据库聚合或预处理
Collection 分组本质是内存操作，不适合万级原始记录。
- 若只需统计数，用
DB::raw('COUNT(*) as count')+ 查询构建器groupBy()，数据库直接返回聚合结果 - 若需把子项拼成字符串（如 MySQL 的
GROUP_CONCAT、PostgreSQL 的STRING_AGG），在select()里写好，避免 PHP 层遍历 - 分页场景慎用：数据库分组后接
paginate()会失效；集合分组后用forPage()是可行的，但前提是get()已完成且内存扛得住 - 本地开发不报错、线上崩？检查 MySQL 是否开启
ONLY_FULL_GROUP_BY，别关它，改代码适配才可靠
真正麻烦的不是怎么写 groupBy()，而是分组前没确认字段是否存在于每条数据里，以及分组后忘了转数组就扔给 JSON 响应——这两个点一漏，问题往往藏得深、复现难。
