如何在Laravel邮件器中直接设置SMTP凭据而不使用配置值？

问题原因 #

Laravel的MailManager会缓存已创建的邮件驱动实例，而队列进程是常驻内存的。当同一进程处理多个队列任务时，直接修改config()不会触发邮件驱动实例的重新初始化，导致后续任务复用了前一次任务的SMTP凭据。

解决方案 #

不要修改全局配置，而是动态创建独立的邮件驱动实例，直接传入当前任务的SMTP凭据，彻底避免依赖缓存的实例。

修改后的代码示例 #

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

    protected $recipient;
    protected $content;
    protected $subject;
    protected $emailLog;
    protected $emailDraftSettings;
    protected $processedVideo;

    /**
     * Create a new job instance.
     *
     * @return void
     */
    public function __construct(
        $recipient,
        $content,
        $subject,
        $emailLog,
        $emailDraftSettings,
        $processedVideo
    ) {
        $this->recipient = $recipient;
        $this->content = $content;
        $this->subject = $subject;
        $this->emailLog = $emailLog;
        $this->emailDraftSettings = $emailDraftSettings;
        $this->processedVideo = $processedVideo;
    }

    public function handle()
    {
        try {        
            $emailSettings = $this->emailDraftSettings;
            
            // 构建当前任务专属的SMTP配置
            $smtpConfig = [
                'transport' => 'smtp',
                'host' => $emailSettings->smtp_host ?? config('mail.mailers.smtp.host'),
                'port' => $emailSettings->smtp_port ?? config('mail.mailers.smtp.port'),
                'encryption' => $emailSettings->smtp_encryption ?? config('mail.mailers.smtp.encryption'),
                'username' => $emailSettings->from_email_id,
                'password' => $emailSettings->from_email_password,
                'timeout' => null,
                'auth_mode' => null,
            ];

            // 创建独立的邮件驱动实例
            $mailer = Mail::getManager()->create('dynamic-smtp', $smtpConfig);

            // 设置统一发件人（也可在Mailable的build方法中动态设置）
            $mailer->alwaysFrom($emailSettings->from_email_id, $emailSettings->name);

            // 发送邮件
            $mailer->to($this->recipient)
                ->send(new BusinessInquiryEmail($this->content, $this->subject));

            $this->emailLog->is_email_sent = EmailLog::SENT;
            $this->emailLog->save();
        } catch (Exception $e) {
            $this->emailLog->is_email_sent = EmailLog::FAILED;
            $this->emailLog->failure_reason = $e->getMessage();
            $this->emailLog->save();
            Log::error('Error occurred while sending email: ' . $e->getMessage());
        }
    }
}

关键说明 #

1. 禁用全局配置修改：直接修改config()会污染进程内的全局状态，导致后续任务串用错误配置，必须完全避免这种方式。
2. 动态创建驱动实例：通过Mail::getManager()->create()方法，每次生成全新的SMTP驱动实例，确保当前任务的凭据完全独立。
3. 配置灵活复用：如果emailDraftSettings中没有存储SMTP主机、端口等基础配置，可以直接从默认的smtp邮件配置中读取，仅覆盖用户名和密码即可。
4. 发件人设置：可以通过$mailer->alwaysFrom()统一设置，也可以在BusinessInquiryEmail的build()方法中根据传入的参数动态配置，两种方式都能保证发件人信息与当前SMTP凭据匹配。

额外注意事项 #

• 确保emailDraftSettings对象能被正常序列化（如果是Eloquent模型，Laravel的SerializesModels trait会自动处理）。
• 若使用队列进程管理器（如Supervisor），无需额外调整进程配置，该方案已兼容单进程多任务的场景。

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