Laravel API列表调用如何避免计算模型属性产生的N次查询问题

方案1：使用带条件的withCount预加载（推荐） #

这是符合Laravel原生设计的最优解法，只需要额外1次查询就能拿到所有记录的统计值：

1. 先在MyModel模型中定义带条件的关联：

// app/Models/MyModel.php
public function xyzTypeRelatedModels()
{
    return $this->hasMany(MyModel::class, 'fk_id')
        ->where('model_type', 'xyz');
}

2. 控制器查询数据时，用withCount预加载统计值：

$records = MyModel::withCount('xyzTypeRelatedModels')->get();

执行上述代码后，Laravel会自动给每个模型实例附加xyz_type_related_models_count属性，存储对应统计值。
3. 资源类直接调用预加载好的属性即可：

class MyModelSimpleResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'my_calculated_attribute' => $this->xyz_type_related_models_count,
        ];
    }
}

方案2：手动批量预计算（适用于更复杂的自定义统计逻辑） #

如果你的统计规则非常复杂，没法用关联+withCount实现，可以手动批量统计后挂载到模型实例：

// 先查主数据
$records = MyModel::get();
// 一次性统计所有记录的对应值
$statData = MyModel::selectRaw('fk_id, COUNT(*) as calc_val')
    ->where('model_type', 'xyz')
    ->whereIn('fk_id', $records->pluck('id'))
    ->groupBy('fk_id')
    ->pluck('calc_val', 'fk_id');
// 把统计值挂载到每个模型实例
$records->each(function ($item) use ($statData) {
    $item->my_calculated_attribute = $statData[$item->id] ?? 0;
});

后续资源类直接读取挂载好的my_calculated_attribute属性即可，全程仅执行2次查询，无N+1问题。

核心原则 #

资源类的唯一职责是做数据格式转换，所有查询、计算逻辑都要提前在控制器/业务逻辑层完成，从根源上避免在数据遍历环节执行单条查询。

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