Laravel中动态SMTP结合队列邮件失效问题求助

问题核心：队列进程是独立运行的，不会继承当前请求中修改的动态SMTP配置，闭包任务序列化时也不会携带这些配置，导致队列执行时默认使用系统配置的SMTP参数。

解决方案：使用独立任务类传递动态配置 #

1. 创建队列任务类 #

执行命令生成任务类：

php artisan make:job SendDynamicMail

2. 修改任务类代码 #

在任务类中接收动态SMTP配置，执行邮件发送前重新设置系统配置：

<?php

namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Config;

class SendDynamicMail implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    protected $details;
    protected $email;
    protected $name;
    protected $ownerEmail;
    protected $brandName;
    protected $mailSubject;
    protected $smtpConfig;

    public function __construct($details, $email, $name, $ownerEmail, $brandName, $mailSubject, $smtpConfig)
    {
        $this->details = $details;
        $this->email = $email;
        $this->name = $name;
        $this->ownerEmail = $ownerEmail;
        $this->brandName = $brandName;
        $this->mailSubject = $mailSubject;
        $this->smtpConfig = $smtpConfig;
    }

    public function handle(): void
    {
        // 动态覆盖SMTP配置
        Config::set('mail.mailers.smtp.host', $this->smtpConfig['host']);
        Config::set('mail.mailers.smtp.port', $this->smtpConfig['port']);
        Config::set('mail.mailers.smtp.username', $this->smtpConfig['username']);
        Config::set('mail.mailers.smtp.password', $this->smtpConfig['password']);
        Config::set('mail.mailers.smtp.encryption', $this->smtpConfig['encryption']);

        // 发送邮件
        Mail::send('mail.mailSchedule', $this->details, function ($m) {
            $m->to($this->email, $this->name);
            $m->from($this->ownerEmail, $this->brandName);
            $m->subject($this->mailSubject);
        });
    }
}

3. 调度任务替换原闭包 #

获取你的动态SMTP配置（比如从数据库、请求参数中获取），然后调度任务：

// 示例动态SMTP配置，根据实际场景替换
$smtpConfig = [
    'host' => 'smtp.example.com',
    'port' => 587,
    'username' => 'your-email@example.com',
    'password' => 'your-smtp-password',
    'encryption' => 'tls',
];

// 调度任务
dispatch(new \App\Jobs\SendDynamicMail(
    $details, 
    $email, 
    $name, 
    $ownerEmail, 
    $brandName, 
    $mailSubject, 
    $smtpConfig
))->delay(now()->addSeconds());

原理说明 #

队列进程启动时会加载默认的config/mail.php配置，闭包任务无法序列化并传递请求中修改的临时配置。通过将动态SMTP配置作为参数传入任务类，在任务执行时主动覆盖系统配置，就能确保邮件使用指定的SMTP参数发送。

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