Laravel中间表CreatorListing的Observer事件无法触发问题排查

核心问题拆解 #

1. 未添加->using(CreatorListing::class)时事件不触发：
   Laravel默认使用内置的Pivot类处理多对多关联，而非你自定义的CreatorListing模型。你注册的Observer是绑定到CreatorListing的，自然不会触发默认Pivot的事件。

2. 添加->using()后报Array to string conversion：
   你在attach时传入的workflow是ValueObjectsWorkflow对象，自定义中间表模型默认会把pivot字段当成普通数据库字段处理，直接存储对象会触发类型转换错误。

分步解决方案 #

1. 确保自定义中间表模型CreatorListing正确定义 #

自定义Pivot模型必须继承Illuminate\Database\Eloquent\Relations\Pivot，同时配置必要属性：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class CreatorListing extends Pivot
{
    // 确认表名与数据库实际表名一致（默认是按字母顺序拼接的蛇形名，比如creator_listing）
    protected $table = 'creator_listing';

    // 允许批量赋值的字段，要包含所有pivot字段
    protected $fillable = [
        'counter_offer',
        'workflow',
        'is_contract_signed',
        'is_accepted',
        'review_status',
    ];

    // 如果中间表有自增ID，开启此选项（默认false）
    public $incrementing = true;

    // 对复杂字段做类型转换，解决对象存储问题
    protected $casts = [
        'workflow' => \App\Casts\WorkflowCast::class, // 自定义Cast类，下文实现
        'is_contract_signed' => 'boolean',
        'is_accepted' => 'boolean',
    ];
}

2. 实现自定义Cast处理ValueObjectsWorkflow序列化 #

创建WorkflowCast类，负责对象与数据库存储格式的互相转换：

<?php

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
use App\ValueObjects\ValueObjectsWorkflow;
use App\Enums\PlatformType;

class WorkflowCast implements CastsAttributes
{
    // 从数据库读取时，转成ValueObjectsWorkflow对象
    public function get($model, $key, $value, $attributes)
    {
        if (is_null($value)) return null;
        
        $data = json_decode($value, true);
        return new ValueObjectsWorkflow(PlatformType::from($data['platform']));
    }

    // 存入数据库时，把对象序列化为JSON字符串
    public function set($model, $key, $value, $attributes)
    {
        if ($value instanceof ValueObjectsWorkflow) {
            return json_encode([
                'platform' => $value->platform->value, // 假设PlatformType是枚举，取其值
                // 若ValueObjectsWorkflow有其他属性，在此一并序列化
            ]);
        }

        return $value;
    }
}

3. 正确注册Observer #

在AppServiceProvider的boot方法中注册CreatorListing的Observer：

public function boot()
{
    \App\Models\CreatorListing::observe(\App\Observers\CreatorListingObserver::class);
}

4. 验证效果 #

现在调用attach方法时，workflow会被自动序列化存入数据库，同时CreatorListing的created事件会正常触发，Observer中的dd(1)会执行。

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