Laravel 10队列任务中关联模型的中间表数据丢失问题求助

我在ModelA与ModelB之间建立了带中间表数据的多对多关联：

ModelA中的关联方法：

public function modelbs()
{
    return $this->belongsToMany(ModelB::class)->withTimestamps()->withPivot([
        'pivot_data_1',
    ]);
}

ModelB中的关联方法：

public function modelas()
{
    return $this->belongsToMany(ModelA::class)->withTimestamps()->withPivot([
        'pivot_data_1',
    ]);
}

关联功能正常，但在调度命令中查询关联模型并分发到GetSomethingJob时出现问题：

$modelAs = ModelA::with('modelbs')->get();
foreach ($modelAs as $modelA){
   foreach ($modelA->modelbs as $modelB) 
      {
        GetSomethingJob::dispatch($modelA, $modelB);
       }
}

任务分发前及Job构造函数中都能看到并访问中间表数据：

public ModelA $modela;
public ModelB $modelb;
public function __construct($modela, $modelb)
{
    dd($modelb);
    $this->modela=$modela;
    $this->modelb=$modelb;
     dd($this->modelb);
}

但当队列实际执行任务时，仅能获取模型实例却丢失了中间表数据。请问是否需要额外配置，让Laravel保留分发时的中间表数据？

这是因为Laravel队列序列化模型时，只会保存模型主键等核心标识信息，不会自动携带关联的中间表（pivot）数据。队列执行任务时会重新从数据库查询模型实例，之前预加载的pivot数据不会被保留。

以下是三种可行的解决方法：

方法一：手动传递pivot数据 #

分发任务时直接把需要的pivot数据单独传入Job，执行时直接使用即可：

// 修改调度命令中的分发逻辑
foreach ($modelAs as $modelA){
   foreach ($modelA->modelbs as $modelB) 
      {
        GetSomethingJob::dispatch($modelA, $modelB, $modelB->pivot->pivot_data_1);
       }
}

// 修改Job类的构造函数与属性
public ModelA $modela;
public ModelB $modelb;
public $pivotData1;

public function __construct($modela, $modelb, $pivotData1)
{
    $this->modela = $modela;
    $this->modelb = $modelb;
    $this->pivotData1 = $pivotData1;
}

// 任务执行时直接调用$this->pivotData1

方法二：在Job中重新加载关联与pivot数据 #

如果不想手动传递数据，可在Job的handle方法中重新查询关联并指定需要的pivot字段：

public function handle()
{
    // 重新加载关联并获取对应pivot数据
    $this->modelb->load(['modelas' => function ($query) {
        $query->where('model_a_id', $this->modela->id)->withPivot('pivot_data_1');
    }]);
    
    // 此时可通过$this->modelb->pivot->pivot_data_1访问中间表数据
}

方法三：自定义模型序列化（进阶） #

如果需要频繁携带pivot数据，可在模型中重写序列化方法，将pivot数据加入序列化内容：

// 在ModelB中添加序列化逻辑
public function serialize()
{
    $data = parent::serialize();
    if (isset($this->pivot)) {
        $data['pivot'] = $this->pivot->toArray();
    }
    return $data;
}

// 同时重写反序列化方法，恢复pivot数据
public function unserialize($data)
{
    parent::unserialize($data);
    if (isset($data['pivot'])) {
        $this->pivot = new \Illuminate\Database\Eloquent\Relations\Pivot(
            $this->modelas()->getTable(),
            $data['pivot'],
            $this->modelas()->getForeignPivotKeyName(),
            $this->modelas()->getRelatedPivotKeyName(),
            true
        );
    }
}

注意：方法三需注意数据一致性问题——如果中间表数据在任务分发后到执行前发生变更，序列化的旧数据会与数据库最新数据不一致，需根据业务场景选择合适方案。

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