Laravel使用环境变量发送邮件失败问题求助

问题场景 #

硬编码收件邮箱时邮件发送正常：

Mail::to('mail@example.com')->send(new \App\Mail\CheckinInfo([
   'client' => $client,
]));

改用环境变量后发送失败：

Mail::to(env('MAIL_FROM_ADDRESS'))->send(new \App\Mail\CheckinInfo([
   'client' => $client,
]));

.env配置（两种写法均尝试过）：

MAIL_FROM_ADDRESS=mail@example.com

MAIL_FROM_ADDRESS="mail@example.com"

已执行缓存清除操作，仍报错：

[2022-07-29 18:44:26] production.ERROR: An email must have a "To", "Cc", or "Bcc" header. {"exception":"[object] (Symfony\Component\Mime\Exception\LogicException(code: 0): An email must have a "To", "Cc", or "Bcc" header. at /www/htdocs/app/laravel/vendor/symfony/mime/Message.php:128)

排查与解决方法 #

1. 确认环境变量是否正确读取 #

先临时调试输出环境变量的值，验证能否正常获取：

dd(env('MAIL_FROM_ADDRESS'));

如果输出为空或非预期值，执行以下命令重置配置缓存：

# 清除配置缓存
php artisan config:clear
# 清除应用缓存
php artisan cache:clear
# 生产环境需重新缓存配置时执行：
php artisan config:cache

注意：生产环境执行config:cache后，后续修改.env文件不会直接生效，必须重新执行config:clear或config:cache更新缓存。

2. 检查变量名拼写与用途 #

MAIL_FROM_ADDRESS默认是Laravel发件人邮箱的配置项，用来做收件人没问题，但要确保变量名没有拼写错误（比如少写字符、大小写错误）。

3. 排查邮件类内部逻辑 #

检查App\Mail\CheckinInfo的build方法，是否存在硬编码覆盖收件人的代码：

// 错误示例：覆盖外部传入的收件人
public function build()
{
    return $this->to('other@example.com')
                ->view('emails.checkin');
}

如果有此类代码，外部Mail::to()的设置会被覆盖，导致实际未设置有效收件人。移除硬编码的to()调用，或调整逻辑合并外部收件人。

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