laravel邮件发送失败需检查驱动配置：一、设mail_mailer=smtp等；二、配smtp参数如mail_host、port、凭据；三、修改config/mail.php并清缓存；四、可选mailgun驱动；五、调试用log驱动。
如果您在Laravel项目中需要实现邮件发送功能，但邮件无法正常发出，则可能是由于邮件发送驱动未正确配置或环境变量设置有误。以下是配置Laravel邮件发送驱动的具体方法：
一、配置MAIL_MAILER环境变量
此步骤用于指定Laravel使用的默认邮件驱动类型，决定底层调用哪一类邮件服务。Laravel支持smtp、mailgun、postmark、ses、log、array等多种驱动，其中smtp最常用于自建或第三方SMTP服务。
1、打开项目根目录下的.env文件。
2、找到并修改MAIL_MAILER行，将其值设为所需驱动，例如：MAIL_MAILER=smtp。
3、确保该行未被注释（即行首无#号），且等号前后无空格。
二、配置SMTP基础连接参数
当使用smtp驱动时，必须提供服务器地址、端口、加密方式及认证凭据，以建立安全的发信通道。
1、在.env文件中设置以下变量：
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
2、若使用QQ邮箱，MAIL_HOST应改为smtp.qq.com，MAIL_PORT可选587（TLS）或465（SSL）。
3、注意：Gmail需启用“应用专用密码”，QQ邮箱需开启SMTP服务并获取授权码，不可直接使用登录密码。
三、配置config/mail.php中的传输选项
此步骤用于覆盖默认配置，适配特殊网络环境或自定义行为，如强制启用SSL、调整超时时间等。
1、打开config/mail.php文件。
2、定位到'smtp'数组键下的'stream'子键（若不存在则手动添加）。
3、插入如下配置以强制使用TLS加密：
'stream' => ['ssl' => ['allow_self_signed' => true, 'verify_peer' => false]]
4、如需延长连接超时，可在同一数组中添加'timeout' => 30。
5、修改后需执行php artisan config:clear清除配置缓存，否则更改不生效。
四、使用Mailgun驱动替代SMTP
Mailgun提供API方式发送邮件，适合高并发场景，无需维护SMTP连接状态，且具备完善的日志与统计能力。
1、注册Mailgun账户并验证域名或沙盒邮箱。
2、在.env中设置：MAIL_MAILER=mailgun。
3、添加以下变量：
MAILGUN_DOMAIN=sandbox123456789.mailgun.org
MAILGUN_SECRET=pubkey-1234567890abcdef
MAILGUN_ENDPOINT=https://api.mailgun.net/v3
4、运行composer require mailgun/mailgun-php安装官方SDK。
5、沙盒域名仅允许向已验证的收件人地址发信，生产环境须绑定自有域名。
五、启用log驱动进行本地调试
此方法不实际发送邮件，而是将原始邮件内容写入日志文件，便于快速验证模板渲染、收件人字段、主题等逻辑是否正确。
1、将.env中的MAIL_MAILER改为log。
2、确保config/logging.php中'channels'包含'stack'且默认日志通道可用。
3、发送测试邮件后，检查storage/logs/laravel.log中是否包含[mail]标记的日志条目。
4、log驱动下所有邮件均不会离开本地，适合开发阶段排除模板与数据绑定问题。
