laravel 在生产环境中无法发送邮件，常见原因包括 gmail 应用专用密码失效、smtp 配置错误或驱动不匹配；本文提供从配置修正、安全设置验证到调试技巧的完整解决方案。
在 Laravel 项目部署至生产环境（如 OVH 云服务器 + Laravel Forge）后，突然所有网站（包括 WordPress 和 Laravel 应用）均无法发送邮件，且日志中无报错、收件箱与垃圾邮件箱均无踪迹——这通常并非代码逻辑问题，而是 SMTP 认证或传输层配置失效所致。尤其当使用 Gmail 作为发信服务时，最常见且隐蔽的根源是 Google 账户启用了两步验证但未使用「应用专用密码」，或原有应用密码已过期/被撤销。
✅ 正确的 Gmail SMTP 配置（推荐用于生产）
请严格按以下配置更新 .env 文件（注意：MAIL_DRIVER 必须为 smtp，而非 mail；Gmail 官方已弃用 smtp.googlemail.com，应统一使用 smtp.gmail.com）：
MAIL_DRIVER=smtp MAIL_HOST=smtp.gmail.com MAIL_PORT=587 MAIL_USERNAME=noreply@yourdomain.com # 必须是已启用两步验证的 Gmail 账户（支持 @gmail.com 或 Google Workspace 域名） MAIL_PASSWORD="your_app_specific_password" # ⚠️ 关键！不是邮箱登录密码，而是 Google 账户中生成的「应用专用密码」 MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=noreply@yourdomain.com MAIL_FROM_NAME="Your App Name"
? 如何生成应用专用密码？ 登录对应 Gmail 账户 → 进入 Google 账户安全设置 开启「两步验证」（若未开启，需先启用） 在「应用专用密码」区域点击生成 → 选择应用为「邮件」、设备为「其他（自定义名称）」→ 生成 16 位密码 将该密码完整复制（含引号）填入 .env 的 MAIL_PASSWORD 字段
⚠️ 其他关键检查项
- 禁止使用 MAIL_DRIVER=mail + Gmail：该驱动依赖系统 sendmail，而 Gmail 不接受未经认证的本地 relay，极易被拒绝或静默丢弃。
- 避免 SSL 端口 465 与 ssl 加密混用旧配置：虽然技术上可行，但 Gmail 官方推荐 PORT=587 + ENCRYPTION=tls 组合，兼容性与稳定性更佳。
- 确保域名邮箱已验证：若使用 noreply@yourdomain.com，需确认该邮箱已在 Google Workspace 中正确配置并拥有发信权限（非仅转发）。
- Forge 服务器防火墙/SELinux：Laravel Forge 默认开放常用端口，但仍建议运行 sudo ufw status 检查是否意外屏蔽了 587 端口。
? 快速验证配置是否生效
在生产环境执行以下 Artisan 命令手动触发测试邮件（替换为真实收件地址）：
php artisan tinker
>>> Mail::to('test@example.com')->send(new Illuminate\Mail\Mailable());
# 或使用内置测试类（Laravel 9+）
>>> Mail::raw('Test from production!', function ($message) { $message->to('test@example.com')->subject('Laravel Mail Test'); });同时开启 Laravel 日志调试（临时）：
LOG_LEVEL=debug MAIL_LOGGING=true # Laravel 9.24+ 支持，会将邮件内容写入 storage/logs/laravel.log
✅ 总结
邮件“无声失败”往往源于认证链断裂而非网络或代码问题。核心修复路径为：停用旧密码 → 启用两步验证 → 生成应用专用密码 → 切换为 smtp 驱动 + 587/tls 标准配置 → 清除配置缓存：
php artisan config:clear php artisan cache:clear # Forge 部署后务必重载 PHP-FPM 或重启队列服务（如使用 Horizon）
完成上述步骤后，90% 的 Gmail 邮件发送异常即可解决。如仍失败，请检查 Google 账户的「安全性活动」页面，确认是否有被阻止的登录尝试，并临时允许“不够安全的应用”（仅作诊断，不建议长期开启）。
