Laravel 9 Resource返回额外数组键及格式不一致问题排查

问题根源 #

1. Collection序列化规则导致格式差异
   Laravel的Collection转JSON时，只有当集合的键是从0开始的连续整数，才会输出数组格式；如果过滤后的集合保留了原集合的非连续索引（比如原数据的主键或原集合的位置键），就会被序列化为带数字键的对象。你遇到的bankBrokers是数组，只是巧合它的过滤结果索引连续，而另外两个字段的过滤结果索引不连续，所以出现对象格式。

2. 查询写法低效且保留原索引
   你用CompanyDefinition::all()->where('company_id', $companyId)是先拉全表数据到内存再过滤，不仅性能差，还会保留原集合的索引；后续再按type过滤时，子集依然带着这些非连续索引，最终导致JSON序列化异常。

3. Resource使用不符合规范
   单个CompanyDefinitionResource是用来包装单个模型的，处理集合应该用CompanyDefinitionResource::collection()，虽然这不是直接引发索引问题的原因，但属于Laravel开发的规范问题。

解决办法 #

方法一：优化查询+重置索引 #

先修正查询逻辑，在数据库层面过滤数据，再对每个分组集合调用values()重置索引，确保索引连续：

修正路由代码：

Route::get("/definitions/{companyId}", function($companyId) {
    // 数据库层面直接过滤，返回索引连续的集合
    $definitions = CompanyDefinition::where('company_id', $companyId)->get();
    // 用collection方法包装集合（符合Resource规范）
    return CompanyDefinitionResource::collection($definitions);
});

修正Resource代码：

public function toArray($request)
{
    $companies = $this->resource;
    return [
        'bankBrokers' => $companies->where('type', 1)->values(),
        'shippers' => $companies->where('type', 2)->values(),
        'accompanyingDocuments' => $companies->where('type', 3)->values(),
    ];
}

方法二：直接分组处理（更直观） #

在控制器中直接对查询结果分组，再返回结构化数据，避免Resource的额外处理：

Route::get("/definitions/{companyId}", function($companyId) {
    $definitions = CompanyDefinition::where('company_id', $companyId)->get();
    $grouped = $definitions->groupBy('type');

    return response()->json([
        'bankBrokers' => $grouped->get(1, collect())->values(),
        'shippers' => $grouped->get(2, collect())->values(),
        'accompanyingDocuments' => $grouped->get(3, collect())->values(),
    ]);
});

效果验证 #

修改完成后，所有字段都会以数组格式返回，不会再出现带数字键的对象结构。

内容的提问来源于stack exchange，提问作者mehmetserif