Laravel Mail::queue邮件主题未生效问题及缓存清除咨询

一、核心问题：临时属性序列化丢失 #

你遇到的邮件主题变成类名的根本原因，是给Payments模型实例添加的临时属性subject没有被序列化到队列任务中。

你在调用队列前设置了$payment->subject = 'Your account has been canceled'，但Laravel模型序列化时默认只包含数据库表中定义的字段，临时添加的属性不会被保存到队列任务里。日志记录的是调用队列时的临时属性值，但队列worker执行任务时，拿到的payment实例是没有subject属性的，此时Laravel会自动用邮件类名作为默认主题。

修复方案：避免依赖模型临时属性 #

有两种简单的修复方式：

方式1：单独传递主题参数

修改调用代码和邮件类：

// 调用处
$payment = \App\Models\Payments::findOrFail($id);
// 把主题作为单独参数传入邮件类
\Mail::queue(new \App\Mail\PlanExpiringOrExpired($payment, 'Your account has been canceled'));

// 邮件类代码
<?php

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;

class PlanExpiringOrExpired extends Mailable
{
    use Queueable, SerializesModels;

    private $payment;
    private $emailSubject;

    public function __construct($payment, $emailSubject)
    {
        $this->payment = $payment;
        $this->emailSubject = $emailSubject;
        \Log::debug("Subject: {$this->emailSubject}");
    }

    public function build()
    {
        return $this->to($this->payment->email, $this->payment->name)
            ->subject($this->emailSubject) // 在这里设置主题
            ->view('mails/payment')
            ->with('payment', $this->payment);
    }
}

方式2：在邮件类构造中保存主题到独立属性

如果坚持要通过模型传递，可在构造函数中把临时属性值保存到邮件类自己的属性里（避免依赖模型序列化）：

// 邮件类构造函数修改
public function __construct($payment)
{
    $this->payment = $payment;
    $this->emailSubject = $payment->subject; // 把临时属性值存到邮件类属性
    \Log::debug("Subject: {$this->emailSubject}");
}

// build方法中使用
->subject($this->emailSubject)

二、生产环境缓存清理与队列重启 #

由于你用Supervisor管理队列worker，修改代码后需要确保队列加载最新代码：

1. 清除应用缓存
   执行以下Artisan命令（代码调用或终端执行均可）：

   \Artisan::call('cache:clear');
   \Artisan::call('config:clear'); // 若修改过配置相关内容
   

   这些命令仅清空缓存文件，对生产服务无中断影响，用户不会感知到异常。

2. 重启队列Worker
   队列worker会缓存已加载的类文件，必须重启才能加载修改后的代码。通过Supervisor命令重启：

   supervisorctl restart [你的队列worker进程名]:*
   

   替换[你的队列worker进程名]为你在Supervisor配置中设置的进程名。重启时，正在处理的任务会被放回队列（需确保配置了合理的--tries参数），不会丢失任务。

额外注意点 #

• 不要在Mailable的构造函数中设置subject，队列执行时构造函数的设置可能因序列化问题失效，统一在build()方法中设置主题更可靠。
• 若使用模型传递数据，尽量只依赖数据库中已存在的字段，临时属性需特殊处理，避免序列化丢失。

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