Laravel如何配置SMTP发送邮件通知？（避坑指南）-Laravel-PHP中文网

laravel邮件配置应写在.env文件中，且修改后必须运行php artisan config:clear清缓存；mail_port与mail_encryption须配套：587配tls、465配ssl；gmail需用应用专用密码而非登录密码。

laravel如何配置smtp发送邮件通知？（避坑指南）

SMTP 配置项写在 `.env` 还是 `config/mail.php`？

Laravel 的邮件配置优先级是：.env > config/mail.php，但很多人改了 .env 却没清缓存，导致配置不生效。config/mail.php 里所有 SMTP 相关字段（如 MAIL_HOST、MAIL_PORT、MAIL_USERNAME）都应从环境变量读取，而不是硬编码。

确保 .env 中包含完整 SMTP 凭据：

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your@gmail.com
MAIL_PASSWORD=your-app-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your@gmail.com
MAIL_FROM_NAME="Your App"

修改 .env 后必须运行 php artisan config:clear，否则 Laravel 仍用缓存里的旧配置
Gmail 用户注意：MAIL_PASSWORD 不能填邮箱登录密码，得用 Google 账户开启「两步验证」后生成的「应用专用密码」

为什么 `MAIL_ENCRYPTION` 设成 `tls` 却报 connection refused？

这不是加密方式选错，而是端口和加密协议没对齐。MAIL_PORT 和 MAIL_ENCRYPTION 必须配套使用：

MAIL_PORT=587 → MAIL_ENCRYPTION=tls（显式 TLS，连接后升级）
MAIL_PORT=465 → MAIL_ENCRYPTION=ssl（隐式 SSL，一上来就加密）
MAIL_PORT=25 → 一般不用，多数云服务器封了 25 端口，且不推荐明文传输

常见错误：把 Gmail 的 587 端口配成 ssl，或把 Outlook 的 465 配成 tls，都会直接连接失败，日志里通常只显示 Connection refused 或 stream_socket_client(): unable to connect

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

发邮件时抛出 `Symfony\Component\Mailer\Exception\TransportException` 怎么定位？

这个异常太宽泛，实际原因可能差很远。别急着查 Laravel 文档，先看底层报错细节：

在本地开发时加 dd($e->getPrevious()) 或查 storage/logs/laravel.log，真正有用的错误藏在 getPrevious() 里
常见子错误包括：
- Expected response code 250 but got code "535"：认证失败，检查 MAIL_USERNAME 和 MAIL_PASSWORD 是否拼错，或是否用了应用专用密码
- Connection timed out：网络不通，可能是服务器屏蔽了 SMTP 出口（比如阿里云 ECS 默认禁用 25/465/587），需提交工单解封或换服务商
- Failed to authenticate on SMTP server：有些邮箱（如 QQ 邮箱）要求开启「SMTP 服务」并单独设置授权码，不是登录密码

用 `Mail::to()->send()` 测试时收不到邮件，但日志显示 “Message sent”

说明 Laravel 认为发送成功了，但实际可能被拒收、进垃圾箱，或根本没发出去。关键要确认「是否真发到了 SMTP 服务器」：

在 config/mail.php 里临时把 'mail' => ['transport' => 'log']，再试一次，看 storage/logs/laravel.log 里有没有完整的原始 SMTP 会话（含 MAIL FROM、RCPT TO、DATA 内容）
如果 log 里有内容，说明 Laravel 层没问题，问题出在 SMTP 服务商侧（如发信域名未配置 SPF/DKIM，或 IP 被拉黑）
如果 log 里只有 “Message sent” 但无 SMTP 交互，说明配置的 MAIL_MAILER 不是 smtp，可能误设成了 log 或 array

Gmail、Outlook、腾讯企业邮这些主流服务商对发信来源校验越来越严，光配对账号密码远远不够——域名解析、发信频率、邮件内容长度、链接可信度，全会影响最终送达。这点容易被跳过，但恰恰是上线后最常出问题的地方。