Laravel运行包含队列任务的测试时出现serialize报错如何解决

问题原因 #

这个报错是Laravel队列在序列化待推送的任务（你的队列化监听器对应的任务实例）时，事件/监听器实例的__sleep()方法返回了非实例属性名的内容，触发了PHP序列化的原生报错。仅测试环境出现通常是因为测试场景下生成的事件参数、或者实例化的对象（比如Mock对象）和正常请求流程下的实例结构不一致。

修复方案 #

• 方案1：优先给事件类添加Laravel自带的序列化Trait
  如果你的事件类中传递了模型实例，直接在事件类中引入SerializesModels即可，该Trait会自动处理模型的序列化逻辑，避免直接序列化完整模型实例带来的问题：

use Illuminate\Queue\SerializesModels;

class UserEmailUpdated
{
    use SerializesModels; // 加入该行即可

    public $user;
    public $newEmail;

    public function __construct(User $user, string $newEmail)
    {
        $this->user = $user;
        $this->newEmail = $newEmail;
    }
}

• 方案2：测试场景下伪造队列/事件避免序列化
  如果你的测试不需要实际触发监听器的执行逻辑，直接在测试用例开头添加伪造逻辑，跳过队列序列化的步骤即可：

// 伪造队列，所有队列任务都不会真的推送执行
use Illuminate\Support\Facades\Queue;
Queue::fake();

// 或者伪造事件，所有事件都不会真的触发监听器
use Illuminate\Support\Facades\Event;
Event::fake();

• 方案3：手动指定序列化属性
  如果你的事件/监听器里有自定义的属性，或者存在第三方依赖的类序列化异常，可以在对应的类中手动实现__sleep()方法，只返回需要序列化的自定义属性名：

public function __sleep(): array
{
    // 只填入你自己定义的、需要序列化的实例属性名即可
    return ['userId', 'newEmail'];
}

• 方案4：排查测试场景的特殊传参
  检查测试用例中触发事件时传入的参数，是否存在Mock对象、闭包、数据库连接、请求实例这类不可序列化的对象，如果有替换为正常的实例即可。

内容的提问来源于stack exchange，提问作者владимир зайцев