Laravel邮件发送失败需依次检查：一、配置.env邮件参数；二、Gmail需启用两步验证并生成App Password；三、确认config/mail.php驱动与传输设置；四、用Mail::raw或Mailable类发测试邮件；五、启用log驱动记录调试日志。

如果您在Laravel项目中需要实现用户注册验证、密码重置或通知类功能，但邮件无法正常发送，则可能是由于邮件服务未正确配置或环境变量设置有误。以下是配置Laravel邮件发送服务的具体方法：

一、配置.env文件中的邮件参数

此步骤用于定义全局邮件服务的基本连接信息，Laravel会自动读取这些值并注入到MailServiceProvider中。确保所有参数与所选邮件服务商的文档一致。

1、打开项目根目录下的.env文件。

2、根据所用邮件服务（如SMTP、Mailgun、SES等）填写对应字段，以SMTP为例：

MAIL_MAILER=smtp

MAIL_HOST=smtp.gmail.com

MAIL_PORT=587

MAIL_USERNAME=your_email@gmail.com

MAIL_PASSWORD=your_app_password

MAIL_ENCRYPTION=tls

MAIL_FROM_ADDRESS=your_email@gmail.com

MAIL_FROM_NAME="${APP_NAME}"

二、启用Google账户的App Password（适用于Gmail）

当使用Gmail作为SMTP服务时，若启用了两步验证，需生成专用应用密码替代账户密码，否则将因认证失败导致发送失败。

1、登录您的Google账户，进入“管理您的Google账户”页面。

2、点击左侧菜单中的“安全性”选项。

3、在“登录Google”部分，找到并开启“两步验证”。（若已开启则跳过）

4、向下滚动至“应用专用密码”区域，点击进入。

5、在“选择应用”下拉框中选择“邮件”，在“选择设备”中选择“其他（自定义名称）”，输入“Laravel App”。

6、点击“生成”，复制显示的16位密码。

7、将该密码粘贴至.env文件中的MAIL_PASSWORD字段。

三、配置config/mail.php中的驱动与传输设置

此步骤用于显式声明邮件传输方式及扩展参数，尤其适用于多环境差异化配置或使用非标准端口/加密方式的情形。

1、打开config/mail.php文件。

2、确认'default' => env('MAIL_MAILER', 'smtp')与.env中一致。

3、检查'smtp'数组下的键值是否覆盖了必要参数：

'host' => env('MAIL_HOST', 'smtp.mailgun.org'),

'port' => env('MAIL_PORT', 587),

'encryption' => env('MAIL_ENCRYPTION', 'tls'),

'username' => env('MAIL_USERNAME'),

'password' => env('MAIL_PASSWORD'),

4、如需强制启用SSL而非TLS，可将encryption设为'ssl'，并将port改为465。

四、使用Mail::raw或Mailable类发送测试邮件

此步骤用于验证配置是否生效，通过程序调用触发实际发送行为，并捕获异常以定位问题根源。

1、在routes/web.php中添加临时测试路由：

Route::get('/test-mail', function () { ... });

2、在闭包内调用Mail::to('recipient@example.com')->send(new \App\Mail\TestMail());

3、创建Mailable类：php artisan make:mail TestMail。

4、编辑app/Mail/TestMail.php，在build()方法中设置主题与内容：

return $this->subject('Laravel 邮件测试')->view('emails.test');

5、运行php artisan config:clear与php artisan cache:clear刷新配置缓存。

6、访问/test-mail路径，观察是否返回成功响应或抛出Symfony\Component\Mailer\Exception\TransportException。

五、启用Laravel日志记录邮件事件

此步骤用于在不实际发送邮件的前提下捕获原始邮件数据，便于调试格式、收件人、头信息等细节，避免频繁触发服务商配额限制。

1、修改.env文件中的MAIL_MAILER值为log：

MAIL_MAILER=log

2、确保config/logging.php中'channels' => ['stack', 'single', ...]包含'mail'通道定义。

3、在config/logging.php的'channels'数组中添加以下配置：

'mail' => ['driver' => 'daily', 'path' => storage_path('logs/mail.log'), 'level' => 'debug'],

4、执行测试邮件发送逻辑后，检查storage/logs/mail.log中是否记录了完整的RFC 2822格式邮件内容。