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 命令手动触发测试邮件（替换为真实收件地址）：

Work Productivity Word Mail Workflow Helper

构建并排查Microsoft Word邮件合并及DOCX模板工作流，使用合并域、内容控件、文档属性、重复区块、数据等

下载

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 账户的「安全性活动」页面，确认是否有被阻止的登录尝试，并临时允许“不够安全的应用”（仅作诊断，不建议长期开启）。