Laravel预加载关联时模型属性为空的原因咨询

问题现象 #

在Laravel框架中，当在关联逻辑内部访问模型属性时，**预加载（eager loading）会导致所有属性为空，但懒加载（lazy loading）**时可正常工作。

模型关联代码 #

public function organization()
{
    return $this->belongsTo(Organization::class, 'organization_id');
}

public function currentOrder()
{
    // 注意：预加载该关联时此代码无法工作
    // 预加载时模型的所有属性都为null
    $subscription = $this->organization->currentAdhesionSubscription;

    if ($subscription) {
        return $this->morphOne(Order::class, 'parent')
            ->whereHas('ticketsWithPrice', fn($q) => $q->where('ticket_id', $subscription->ticket_id));
    }
}

不同加载方式的表现 #

• 懒加载（正常运行）：

$model->load('currentOrder');
$model->currentOrder;

• 预加载（无法工作）：

$model = Model::with('currentOrder')->first();
$model->currnetOrder; 
// 注：此处原代码存在拼写错误，应为`$model->currentOrder`
// 报错：在null上访问"currentAdhesionSubscription"，此处null是organization关联对象
// 甚至访问模型自身属性（比如id）也返回null

问题原因 #

这是Laravel预加载的机制特性导致的：

1. 预加载时，Laravel会批量查询所有目标模型的关联数据，这个过程中模型实例的属性尚未完成填充，处于"部分初始化"状态。
2. 当在currentOrder关联定义中直接访问$this->organization时，预加载流程还没完成当前模型的属性赋值，导致$this的所有属性（包括关联外键organization_id）都是null，进而无法正确加载organization关联，最终触发访问null对象属性的错误。
3. 懒加载则是在模型实例完全初始化、所有属性都填充完成后才执行关联查询，因此能正常获取到关联数据。

解决方案 #

要让预加载正常工作，需避免在关联定义中直接访问模型实例的关联/属性，改用查询构建器的约束逻辑实现需求：

方案1：通过子查询关联约束 #

public function currentOrder()
{
    return $this->morphOne(Order::class, 'parent')
        ->whereHas('ticketsWithPrice', function ($q) {
            // 根据currentAdhesionSubscription的实际逻辑补充子查询条件
            $q->whereExists(function ($subQ) {
                $subQ->select(DB::raw(1))
                    ->from('adhesion_subscriptions') // 替换为你的订阅表实际表名
                    ->whereColumn('adhesion_subscriptions.ticket_id', 'tickets_with_price.ticket_id')
                    ->whereColumn('adhesion_subscriptions.organization_id', $this->getTable() . '.organization_id')
                    ->where('is_current', true); // 假设currentAdhesionSubscription是指当前有效的订阅
            });
        });
}

方案2：预取订阅ID作为查询条件 #

如果currentAdhesionSubscription是单个记录，可先通过子查询获取对应ticket_id，再用于关联过滤：

public function currentOrder()
{
    // 子查询获取当前组织的有效订阅ticket_id
    $ticketIdSubquery = Organization::select('current_adhesion_subscription.ticket_id')
        ->whereColumn('organizations.id', $this->getTable() . '.organization_id')
        ->limit(1);

    return $this->morphOne(Order::class, 'parent')
        ->whereHas('ticketsWithPrice', fn($q) => $q->whereIn('ticket_id', $ticketIdSubquery));
}

方案3：预加载所有依赖关联（临时兼容方案） #

如果需要保留原有逻辑，可在预加载时同时加载所有依赖的关联，但这种方式性能较差，仅作为临时兼容方案：

// 预加载时同时加载依赖的关联链
$model = Model::with(['currentOrder', 'organization.currentAdhesionSubscription'])->first();

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