Laravel Mailable实现ShouldQueue后无法向Blade传递数据如何解决

问题原因 #

这个问题的核心是Laravel队列常驻进程的代码缓存特性，以及Mailable公共属性自动注入视图在序列化/反序列化场景下的兼容问题：

• 取消ShouldQueue时走同步发送逻辑，PHP每次请求都会重新加载最新的类代码，Mailable实例的公共属性$data可以正常传递到Blade视图，所以运行正常。
• 启用队列后，Mailable实例会被序列化存入队列，消费者进程取出反序列化时，如果进程内存中残留旧版本的ContactFormMail类代码，或者自动注入逻辑触发时机异常，就会导致Blade视图无法识别$data变量。

解决步骤 #

1. 彻底重启队列进程
   Laravel的queue:work是常驻内存进程，修改代码后必须完全重启才能加载新代码，先执行清理命令：

php artisan queue:restart
php artisan cache:clear
php artisan config:clear

然后手动终止所有运行中的queue:work进程，再重新启动队列：

php artisan queue:work

2. 显式传递视图变量
   不要依赖Mailable公共属性自动注入视图的特性，在build方法中手动传递变量，彻底规避注入失效问题，修改ContactFormMail类的build方法：

public function build()
{
    return $this->view('mails.ContactForm', ['data' => $this->data]);
}

3. 可选优化方案
   如果还是出现问题，可以直接把传递的参数拆分为独立的公共属性，避免数组序列化的潜在异常：
   修改ContactFormMail类：

class ContactFormMail extends Mailable implements ShouldQueue
{
    use Queueable, SerializesModels;

    public $name;
    public $email;
    public $message;

    public function __construct($data)
    {
        $this->name = $data['name'];
        $this->email = $data['email'];
        $this->message = $data['message'];
    }

    public function build()
    {
        return $this->view('mails.ContactForm');
    }
}

对应的Blade模板直接调用属性即可：

<div>
    {{$name}}<br>
    {{$email}}<br>
    {{$message}}<br>
</div>

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