Laravel模型HasMany关联带Scope调用问题：属性调用返回空数组

问题根源 #

你定义的regularInvoiceDocs()方法返回的是查询构建器（Builder）实例，而非HasMany关联对象。Laravel通过属性访问关联（如$this->regularInvoiceDocs）时，要求方法返回关联类实例（比如Illuminate\Database\Eloquent\Relations\HasMany），这样框架才能识别并执行关联的延迟加载逻辑。

之前的写法中，$this->billingDocs()->regularType()先返回HasMany实例，调用作用域后转为Builder实例，Laravel无法将其当作关联处理，因此直接访问属性时无法正确拼接当前模型的外键条件，返回空数组；而手动调用->get()是直接执行查询，所以能拿到预期数据。

修复方案 #

修改regularInvoiceDocs方法，让它返回绑定了作用域的HasMany关联实例：

public function regularInvoiceDocs()
{
    return $this->hasMany(BillingDoc::class)->regularType();
}

这样返回的依然是HasMany关联对象，只是预先附加了regularType的作用域条件。此时$this->regularInvoiceDocs就能像$this->billingDocs一样，被Laravel正确识别为关联，自动带上当前Dossier模型的外键约束，同时应用作用域过滤，返回正确的数据。

验证 #

修改后，直接访问$this->regularInvoiceDocs会触发延迟加载，返回符合条件的BillingDoc集合；也可以配合预加载使用，比如Dossier::with('regularInvoiceDocs')->find($id)，提升查询性能。

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