本文详解如何在 laravel 中通过 eloquent 的嵌套预加载（nested eager loading）一次性查询多级关联模型（如 foodsection → foodcategory → fooditem → alergen），避免 n+1 问题并构建完整菜单树结构。

本文详解如何在 laravel 中通过 eloquent 的嵌套预加载（nested eager loading）一次性查询多级关联模型（如 foodsection → foodcategory → fooditem → alergen），避免 n+1 问题并构建完整菜单树结构。

在构建餐饮类应用的菜单系统时，常需展示「分类区块（FoodSection）→ 分类（FoodCategory）→ 菜品（FoodItem）→ 过敏原（Alergen）」这样的四层嵌套结构。若使用链式 with() 分别加载各层关系（如 ->with('foodCategory')->with('foodItem')），Eloquent 将无法识别层级依赖，导致查询失败或返回空关联——因为 foodItem 并非直接属于 FoodSection，而是属于其子模型 FoodCategory。

正确做法是使用点号分隔的嵌套关系路径，在单个 with() 中声明完整层级：

$menu = FoodSection::withTrashed()
    ->with([
        'foodCategory',                      // 加载一级子模型：FoodCategory
        'foodCategory.foodItem',             // 加载二级：每个 FoodCategory 下的 FoodItem
        'foodCategory.foodItem.alergen',     // 加载三级：每个 FoodItem 关联的 Alergen（注意：此处为 belongsToMany，需确保关系定义正确）
    ])
    ->get();

⚠️ 关键注意事项：

• foodCategory.foodItem.alergen 能生效的前提是 FoodItem 模型中正确定义了 alergen() 关系。你当前代码中 Alergen 使用的是 belongsToMany(FoodItem::class)，但 FoodItem 的 alergen() 方法却返回 hasMany(Alergen::class) —— 这存在逻辑矛盾。若 Alergen 与 FoodItem 是多对多关系（即一个菜品可有多个过敏原，一个过敏原可属于多个菜品），则 FoodItem 应定义为：

  public function alergens()
  {
      return $this->belongsToMany(Alergen::class, 'food_item_alergen'); // 中间表名需匹配
  }

  对应地，查询时应改为 'foodCategory.foodItem.alergens'（方法名复数形式更规范）。

• 若中间表未遵循 Laravel 默认命名（如 food_items_alergens），请在 belongsToMany() 中显式指定中间表名和外键。

  

  Laravel Cloud

  Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

  下载

• 所有被 with() 加载的关联方法名必须与模型中定义的 关系方法名完全一致（区分大小写、复数/单数）。

• 如需对某层关系添加约束（例如仅加载启用的菜品），可使用闭包：

  'foodCategory.foodItem' => function ($query) {
      $query->where('is_active', true);
  }

最终，$menu 将是一个包含完整层级结构的集合，可直接在 Blade 模板中安全遍历：

@foreach($menu as $section)
    <h2>{{ $section->title }}</h2>
    @foreach($section->foodCategory as $category)
        <h3>{{ $category->title }}</h3>
        @foreach($category->foodItem as $item)
            <div>{{ $item->title }} - ¥{{ $item->price }}</div>
            <small>Alergens: {{ $item->alergens->pluck('title')->join(', ') }}</small>
        @endforeach
    @endforeach
@endforeach

掌握嵌套预加载，不仅大幅提升查询效率，更是构建复杂业务数据视图的核心技能。