Laravel Eloquent关联预加载报错：Call to undefined function productListing()

问题背景 #

尝试使用Laravel Eloquent嵌套预加载一次性加载关联模型链，执行以下代码时出现错误：Call to undefined function productListing()

$order = Orders::where('id', $orderId)
          ->with([
              "users",
              "shippingInvoices" => [
                  "shippingInvoiceDetails" => [
                      "orderDetails" => "productListing",
                  ],
                  "vendor"]
          ])->get();

涉及的模型关联定义如下：

• Orders.php

public function users() {
    return $this->belongsTo('App\Users', 'user_id');
}
public function shippingInvoices() {
        return $this->hasMany(ShippingInvoice::class, "order_id");
    }

• ShippingInvoice.php

public function shippingInvoiceDetails(): HasMany
    {
        return $this->hasMany(ShippingInvoiceDetails::class, "invoice_id");
    }

• ShippingInvoiceDetails.php

public function orderDetails(): BelongsTo
    {
        return $this->belongsTo(OrderDetails::class);
    }

• OrderDetials.php

public function productListing() {
        return $this->belongsTo('App\ProductListing', 'product_id');
    }

排查与修复步骤 #

1. 修正模型文件名拼写错误 #

首先发现订单详情模型的文件名是OrderDetials.php，存在拼写错误（缺少字母a），正确的文件名应为OrderDetails.php。

Laravel通过PSR-4自动加载模型，类名OrderDetails必须对应同名的文件名，拼写错误会导致Eloquent无法正确识别模型类，进而触发关联方法未找到的错误。

2. 调整嵌套预加载语法 #

原代码中"orderDetails" => "productListing"的写法有误，嵌套预加载需要使用数组或点语法来声明深层关联：

方式一：使用点语法

$order = Orders::where('id', $orderId)
          ->with([
              "users",
              "shippingInvoices" => [
                  "shippingInvoiceDetails" => ["orderDetails.productListing"],
                  "vendor"
              ]
          ])->get();

方式二：使用嵌套数组

$order = Orders::where('id', $orderId)
          ->with([
              "users",
              "shippingInvoices" => [
                  "shippingInvoiceDetails" => [
                      "orderDetails" => ["productListing"]
                  ],
                  "vendor"
              ]
          ])->get();

3. 验证关联方法一致性 #

确认OrderDetails模型中的productListing()方法拼写正确，方法名的大小写与预加载时使用的名称一致（Laravel支持驼峰和蛇形命名的自动转换，但方法名本身必须准确）。

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