Laravel 生产环境邮件发送失败的排查与解决方案

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）：

? 如何生成应用专用密码？ 登录对应 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

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

同时开启 Laravel 日志调试（临时）：

✅ 总结

邮件“无声失败”往往源于认证链断裂而非网络或代码问题。核心修复路径为：停用旧密码 → 启用两步验证 → 生成应用专用密码 → 切换为 smtp 驱动 + 587/tls 标准配置 → 清除配置缓存：

完成上述步骤后，90% 的 Gmail 邮件发送异常即可解决。如仍失败，请检查 Google 账户的「安全性活动」页面，确认是否有被阻止的登录尝试，并临时允许“不够安全的应用”（仅作诊断，不建议长期开启）。