本文详解 laravel 应用在 ovh 云服务器（通过 laravel forge 部署）中邮件静默失败的典型原因，重点聚焦 gmail smtp 配置错误、应用密码失效及驱动/加密协议不匹配问题，并提供可立即生效的修复配置与验证步骤。
在 Laravel 生产环境中，邮件“无报错却收不到”是最棘手的问题之一——日志空空如也、Mail::raw(...)->send() 返回成功，但收件箱和垃圾邮件箱均无踪迹。你描述的情况（OVH 服务器 + Laravel Forge + 多站点集体失联、Gmail 账户配置）极具代表性，根本原因通常不在网络或防火墙，而在于 Gmail 的安全策略升级与 Laravel 配置的过时组合。
? 核心问题：Gmail 应用密码已失效或未启用
自 2022 年起，Google 全面弃用“用户名+密码”直接登录 SMTP 的方式（尤其对启用了两步验证的账户）。你当前配置中仍使用 MAIL_PASSWORD=*******（即账户主密码），这在现代 Gmail 环境下必然被拒绝，且因 Google 后端静默丢弃连接，Laravel 日志不会记录明显错误——造成“无日志、无报错、无邮件”的假象。
✅ 正确做法是：为 Laravel 生成专属的 App Password（应用专用密码）
- 确保你的 Gmail 账户已开启两步验证（https://www.php.cn/link/e9947b970456f26dd9fe5f427ded41fa）；
- 在同一页面下，进入 “App passwords” → 点击“生成” → 应用类型选 “Mail”，设备选 “Other (Custom name)”，输入如 Laravel-Production；
- 系统将生成 16 位一次性密码（如 abcd efgh ijkl mnop），复制此密码（注意：不含空格），用于替换配置中的 MAIL_PASSWORD。
⚙️ 必须同步修正的 Laravel 邮件配置
原配置存在三处关键不兼容：
- MAIL_DRIVER=mail：调用系统 sendmail，依赖本地 MTA（如 Postfix），在 Forge 环境中易出问题且难以调试；
- MAIL_HOST=smtp.googlemail.com：已弃用，应统一使用 smtp.gmail.com；
- SSL on port 465 + MAIL_DRIVER=mail 组合在新版 Gmail 中握手失败率高。
推荐采用稳定可靠的 smtp 驱动 + TLS 加密（端口 587）：
构建并排查Microsoft Word邮件合并及DOCX模板工作流，使用合并域、内容控件、文档属性、重复区块、数据等
# .env 文件（生产环境） MAIL_DRIVER=smtp MAIL_HOST=smtp.gmail.com MAIL_PORT=587 MAIL_USERNAME=noreply@yourdomain.com # ✅ 必须是已验证的 Gmail 或 Google Workspace 账户 MAIL_PASSWORD="abcd efgh ijkl mnop" # ✅ 替换为上一步生成的 16 位 App Password（含引号！） MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=noreply@yourdomain.com MAIL_FROM_NAME="Your App Name"
? 注意：MAIL_PASSWORD 值必须用双引号包裹，尤其当密码含特殊字符时；Laravel 会自动去除引号并正确解析。
? 验证与调试步骤
完成配置后，务必执行以下操作：
-
清除配置缓存（Forge 环境中常被忽略）：
php artisan config:clear php artisan cache:clear # 在 Forge 面板中重启 PHP-FPM 或运行 `sudo systemctl restart php*-fpm`
-
命令行快速测试（绕过 Web 请求，直连 SMTP）：
php artisan tinker >>> use Illuminate\Support\Facades\Mail; >>> Mail::raw('Test from Laravel production', function ($message) { ... $message->to('your-test@gmail.com')->subject('Laravel SMTP Test'); ... }); 检查 Gmail 账户安全活动：
访问 https://www.php.cn/link/237badad699a572a4071d58e19cdc8b4，确认是否有来自你服务器 IP 的“阻止的登录尝试”——如有，点击“是”确认该活动，否则后续请求将持续被拦截。
⚠️ 重要注意事项
- 域名一致性：MAIL_USERNAME 和 MAIL_FROM_ADDRESS 必须属于同一 Google 账户（例如 noreply@yourdomain.com 需是已添加到 Google Workspace 或 Gmail 别名的地址）；
- 避免使用 @gmail.com 主邮箱：生产环境建议使用 Google Workspace（付费）或配置 Gmail 别名，主邮箱频繁发信易触发风控；
- 替代方案考虑：若长期受 Gmail 限制困扰，推荐迁移到专业邮件服务（如 Mailgun、Postmark、Sendgrid），它们提供更透明的日志、API 级监控和更高发送限额。
遵循以上步骤，95% 的 Laravel Gmail 邮件静默失败问题可立即解决。核心逻辑始终是：信任 Google 的安全机制，而非绕过它——用 App Password 取代主密码，用标准 smtp+tls 取代过时组合，再辅以严谨的缓存清理与验证闭环。
