Laravel队列邮件含附件时序列化失败问题求助

我之前也碰到过一模一样的问题！直接发邮件完全正常，一加入队列就报错，核心原因是Laravel队列任务需要序列化所有传递给它的数据，而你用的$files是Illuminate\Http\UploadedFile对象——这类对象不仅没有实现序列化接口，而且请求结束后PHP会自动删除上传的临时文件，等队列执行的时候文件早就没了，自然会出问题。

给你两个靠谱的解决方案，按你的场景选就行：

方案一：临时存储文件后传路径（快速改造现有代码） #

先把上传的文件保存到服务器的临时存储目录，然后把文件路径传给队列，而不是直接传文件对象：

// 控制器里的代码
// 1. 先保存上传的文件到临时目录（storage/app/temp）
$filePaths = [];
foreach ($files as $file) {
    // store()方法会自动生成唯一文件名，返回存储的相对路径
    $filePaths[] = $file->store('temp');
}

// 2. 把文件路径传入队列邮件，替换原来的$files对象
$this->mail->queue('emails.contact-us', compact('data', 'filePaths'), function($message) use($filePaths) {
    $message->from('email@mail.co.uk', 'Test Sender');
    $message->subject('你的邮件主题');
    
    // 3. 通过文件路径添加附件
    foreach ($filePaths as $path) {
        // 拼接完整路径：storage/app/ + 相对路径
        $message->attach(storage_path('app/' . $path));
    }

    // 4. 邮件发送后删除临时文件（可选但建议，避免占用空间）
    foreach ($filePaths as $path) {
        \Illuminate\Support\Facades\Storage::delete($path);
    }
});

方案二：用Mailable类（Laravel推荐的规范写法） #

如果你的项目经常需要发送带附件的队列邮件，建议生成专门的Mailable类，代码更清晰易维护：

1. 先通过Artisan命令生成Mailable类：

php artisan make:mail ContactUsMail

2. 修改生成的App\Mail\ContactUsMail.php文件：

namespace App\Mail;

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

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

    // 公开属性可以直接在邮件视图中使用
    public $data;
    private $filePaths;

    /**
     * 构造方法：接收业务数据和文件路径数组
     */
    public function __construct($data, $filePaths)
    {
        $this->data = $data;
        $this->filePaths = $filePaths;
    }

    /**
     * 构建邮件内容
     */
    public function build()
    {
        // 基础邮件配置
        $mail = $this->from('email@mail.co.uk', 'Test Sender')
                     ->view('emails.contact-us');

        // 遍历添加所有附件
        foreach ($this->filePaths as $path) {
            $mail->attach(storage_path('app/' . $path));
        }

        // 发送完成后清理临时文件
        foreach ($this->filePaths as $path) {
            \Storage::delete($path);
        }

        return $mail;
    }
}

3. 在控制器中调用这个Mailable类：

// 先保存上传文件到临时目录
$filePaths = [];
foreach ($files as $file) {
    $filePaths[] = $file->store('temp');
}

// 直接通过队列发送Mailable实例
\Illuminate\Support\Facades\Mail::queue(new \App\Mail\ContactUsMail($data, $filePaths));

额外注意事项 #

• 确保storage/app/temp目录有写入权限，Laravel默认存储目录权限是正常的，但如果是自定义目录需要手动设置。
• 如果你担心邮件发送失败导致临时文件没被删除，可以添加一个Laravel定时任务，每天清理一次temp目录中超过24小时的文件。

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