Laravel API：如何在OrderItem资源中正确加载嵌套Product关联

1. 修正关联关系的语义（关键前提） #

OrderItem 与 Product 的关联逻辑是从属关系（OrderItem 属于某个 Product），所以应该用 belongsTo 而非 hasOne——虽然 hasOne 能勉强查询，但不符合 Laravel 关联的语义规范，可能影响资源的预加载判断：

// app/Models/OrderItem.php
public function product()
{
    // Laravel 默认会用 order_items 表的 product_id 关联 products 表的 id，无需额外传参
    return $this->belongsTo(Product::class);
}

2. 预加载嵌套关联（解决 whenLoaded 不生效的核心） #

whenLoaded 只对预加载的关联生效，所以查询订单时必须明确预加载 orderItems 及其嵌套的 product，既避免 N+1 查询，又能触发资源的关联返回：

// 订单接口控制器代码
public function show($id)
{
    $order = Order::with('orderItems.product')->findOrFail($id);
    return new OrderResource($order);
}

3. 资源层保持正确写法 #

在 OrderItemResource 中保留 whenLoaded 的写法即可，它会自动检测 product 关联是否被预加载，只有预加载完成才会返回 Product 数据：

// app/Http/Resources/OrderItemResource.php
public function toArray($request)
{
    return [
        'id' => $this->id,
        'quantity' => $this->quantity,
        'amount' => $this->amount,
        // 其他 OrderItem 字段...
        'product' => new ProductResource($this->whenLoaded('product')),
    ];
}

为什么之前的方案出问题？ #

• whenLoaded 不生效：因为查询时没有预加载 orderItems.product，whenLoaded 检测到关联未被预加载，所以不返回 Product 数据。
• load/loadMissing 导致重复嵌套：在资源中调用 load 会触发每个 OrderItem 单独查询 Product（N+1 问题），如果 Product 模型中定义了 orderItems 关联，会触发循环嵌套，导致数据重复甚至递归溢出。

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