Laravel如何获取两层父级模型的嵌套关联结构？

核心思路是通过组件（Component）作为中间关联层，把组件实例（ComponentInstance）和组件属性（ComponentProperty）关联起来，再通过左连接绑定实例的属性值（ComponentInstanceValue），确保即使实例刚创建无值时也能返回所有预设属性。

1. 定义模型关联 #

Component 模型

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Component extends Model
{
    // 组件拥有多个实例
    public function instances()
    {
        return $this->hasMany(ComponentInstance::class);
    }

    // 组件拥有多个预设属性
    public function properties()
    {
        return $this->hasMany(ComponentProperty::class);
    }
}

ComponentInstance 模型

这里关键是通过hasManyThrough关联组件属性，同时左连接属性值表，确保无值时也能返回属性：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class ComponentInstance extends Model
{
    public function component()
    {
        return $this->belongsTo(Component::class);
    }

    // 关联当前实例对应的所有组件属性，并绑定自身的属性值
    public function properties()
    {
        return $this->hasManyThrough(
            ComponentProperty::class,
            Component::class,
            'id',               // Component表关联ComponentInstance的外键（ComponentInstance.component_id）
            'component_id',     // ComponentProperty表关联Component的外键
            'component_id',     // ComponentInstance的关联键
            'id'                // Component的关联键
        )->leftJoin('component_instance_values', function ($join) {
            $join->on('component_properties.id', '=', 'component_instance_values.component_property_id')
                 ->where('component_instance_values.component_instance_id', '=', $this->id);
        })->select([
            'component_properties.*',
            'component_instance_values.value as instance_value'
        ])->withDefault([
            'instance_value' => null // 无属性值时返回null，保证结构一致
        ]);
    }
}

ComponentProperty 模型

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class ComponentProperty extends Model
{
    public function component()
    {
        return $this->belongsTo(Component::class);
    }

    public function instanceValues()
    {
        return $this->hasMany(ComponentInstanceValue::class);
    }
}

2. 控制器查询（无N+1问题） #

直接通过预加载获取完整嵌套结构，避免手动合并的性能问题：

namespace App\Http\Controllers;

use App\Models\Component;
use Illuminate\Http\Response;

class ComponentController extends Controller
{
    public function index()
    {
        // 预加载组件 -> 实例 -> 属性（含对应值）
        $components = Component::with('instances.properties')->get();

        return response()->json($components);
    }
}

3. 返回的JSON结构示例 #

[
  {
    "id": 1,
    "name": "Hero Banner",
    "instances": [
      {
        "id": 1,
        "component_id": 1,
        "properties": [
          {
            "id": 1,
            "component_id": 1,
            "name": "title",
            "type": "text",
            "instance_value": "欢迎来到我的网站"
          },
          {
            "id": 2,
            "component_id": 1,
            "name": "background",
            "type": "image",
            "instance_value": null // 刚创建的实例无值时返回null
          }
        ]
      }
    ]
  }
]

关键优化点 #

• 用hasManyThrough跳过中间层直接关联实例和属性，避免额外查询
• 左连接属性值表，确保无值时仍返回所有预设属性
• 预加载instances.properties彻底解决N+1查询问题，性能远优于手动合并数据

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