Laravel配置动态SMTP时MailManager::getConfig()参数为null报错如何解决

这个报错的核心原因是Illuminate\Mail\MailManager初始化时，读取到的邮件驱动名称为空，或者你修改SMTP配置的时机晚于MailManager的实例化，旧的单例实例没有读取到更新后的配置，导致获取配置时传入了null值。

解决方案 #

按以下步骤调整代码即可修复： #

1. 调整配置覆盖逻辑，增加空值兜底

你之前的代码只在存在host配置时才赋值，缺少空值兜底，且没有确保默认邮件驱动配置不为空，调整后逻辑如下：

$mailerSettings = Setting::where('type', 'mail')
    ->whereIn('key', ['host', 'port', 'username', 'password', 'encryption'])
    ->pluck('value', 'key');

// 合并自定义配置与默认配置，避免出现null值
$smtpConfig = array_merge(config('mail.mailers.smtp'), $mailerSettings->toArray());
config()->set('mail.mailers.smtp', $smtpConfig);
// 强制指定默认邮件驱动为smtp，避免默认值为null
config()->set('mail.default', 'smtp');

2. 修正中间件逻辑，不要重复注册服务提供者

Laravel容器中已经存在mail.manager的单例实例，直接修改配置后旧实例不会自动更新，重复注册服务提供者也不会刷新已创建的实例，需要手动清空旧实例：

// 把上述配置覆盖逻辑直接放到中间件中执行，不需要额外注册服务提供者
$mailerSettings = Setting::where('type', 'mail')
    ->whereIn('key', ['host', 'port', 'username', 'password', 'encryption'])
    ->pluck('value', 'key');

if ($mailerSettings->isNotEmpty()) {
    $smtpConfig = array_merge(config('mail.mailers.smtp'), $mailerSettings->toArray());
    config()->set('mail.mailers.smtp', $smtpConfig);
    config()->set('mail.default', 'smtp');
    
    // 清空已实例化的邮件相关单例，后续调用会自动用新配置重新初始化
    app()->forgetInstance('mail.manager');
    app()->forgetInstance('mailer');
}

return $next($request);

3. 队列场景特殊处理

如果你是通过队列发送邮件，中间件逻辑不会在队列进程中触发，需要在邮件发送前手动执行上述配置覆盖+清空实例的逻辑，可以放在Mailable类的build()方法中，或者监听MessageSending事件处理。

排查验证

修改完成后如果仍有报错，可以在调用发邮件逻辑前打印以下配置，确认所有值都不为null：

dd(config('mail.default'), config('mail.mailers.smtp'));

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