如何让Laravel中的自定义PartnerData类支持队列调度？

错误原因 #

Laravel队列调度Job时，需要将Job的构造参数序列化后存储到队列驱动（如Redis、数据库）中。你的PartnerData类未实现序列化相关接口，导致队列系统无法正确处理该对象，进而触发"无法转换为字符串"的错误。

解决方案 #

方案1：传递数组，Job内部实例化（最简单） #

无需修改PartnerData类，直接传递原始数据数组，在Job构造函数中完成对象实例化：

修改调度代码：

collect($datas)
    ->each(fn($data) => MyJob::dispatch($data));

修改MyJob类：

class MyJob implements ShouldQueue {

    // 导入所需trait...
 
    private PartnerData $partner;

    public function __construct(array $partnerData)
    {
        $this->partner = new PartnerData($partnerData);
    }

    public function handle()
    {
        // 处理partner数据
    }
}

方案2：让PartnerData实现PHP原生Serializable接口 #

手动定义序列化与反序列化逻辑，让Laravel能正确处理对象：

修改PartnerData类：

class PartnerData implements \Serializable
{
    public string $name;
    public string $phone;

    public function __construct($info)
    {
        $this->name = $info['name'];
        $this->phone = $info['phone'];
    }

    // 定义序列化逻辑，将对象转为可存储字符串
    public function serialize(): string
    {
        return serialize([
            'name' => $this->name,
            'phone' => $this->phone,
        ]);
    }

    // 定义反序列化逻辑，从字符串恢复对象
    public function unserialize($data): void
    {
        $data = unserialize($data);
        $this->name = $data['name'];
        $this->phone = $data['phone'];
    }
}

方案3：实现JsonSerializable接口 #

让对象可转为JSON格式，Laravel队列会自动处理JSON的序列化与反序列化：

修改PartnerData类：

class PartnerData implements \JsonSerializable
{
    public string $name;
    public string $phone;

    public function __construct($info)
    {
        $this->name = $info['name'];
        $this->phone = $info['phone'];
    }

    // 指定对象转JSON的结构
    public function jsonSerialize(): array
    {
        return [
            'name' => $this->name,
            'phone' => $this->phone,
        ];
    }

    // 可选：添加静态方法，从数组快速创建对象
    public static function fromArray(array $data): self
    {
        return new self($data);
    }
}

额外注意 #

你的MyJob构造函数存在拼写错误：$this->partner = $parner; 应改为 $this->partner = $partner;，该错误可能导致Job实例化时出现变量未定义问题。

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