laravel 5.5 在本地使用 mailtrap 正常发送密码重置邮件，但部署到 cpanel 后失效——本文详解 smtp 配置、环境变量、dns 记录及常见陷阱的系统性排查与修复方案。
在 Laravel 5.5 中，密码重置功能依赖 Illuminate\Auth\Passwords\PasswordBroker 和底层邮件服务（如 Mail::send()）。本地开发时通过 Mailtrap 成功收信，而上线后收不到重置链接，根本原因几乎总是生产环境邮件配置未正确适配真实 SMTP 服务，而非框架逻辑问题。
✅ 关键检查项与修复步骤
1. 环境变量必须区分 local 与 production
.env 中 APP_ENV=local 是致命错误——cPanel 生产环境必须设为：
APP_ENV=production APP_DEBUG=false
否则 Laravel 可能跳过部分生产级校验（如邮箱验证），且 config/mail.php 中的 from 地址可能被忽略。
2. SMTP 驱动与加密配置需严格匹配服务商要求
您当前使用 MAIL_DRIVER=mail（PHP mail() 函数），该方式在共享主机（如多数 cPanel）上默认被禁用或不可靠。应强制切换为 smtp：
MAIL_DRIVER=smtp MAIL_HOST=mail.dmdhakamanpower.com MAIL_PORT=465 MAIL_USERNAME="admin@dmdhakamanpower.com" ← 去掉引号！Laravel 不解析带引号的字符串 MAIL_PASSWORD=your_actual_password MAIL_ENCRYPTION=ssl MAIL_FROM_ADDRESS=admin@dmdhakamanpower.com MAIL_FROM_NAME="DMD Hakam Anpower"
⚠️ 注意：MAIL_USERNAME 和 MAIL_PASSWORD 不可加双引号，否则 Laravel 会将引号作为密码一部分导致认证失败。
3. 验证邮箱账户权限与 DNS 设置
- 登录 admin@dmdhakamanpower.com 邮箱后台，确认：
- 已启用 SMTP 发信（部分面板需手动开启“SMTP 认证”）
- 密码为应用专用密码（若启用了两步验证）
- 检查域名 DNS 是否存在合法 MX 和 SPF 记录：
v=spf1 include:secureserver.net ~all ← GoDaddy/cPanel 常见格式
缺失 SPF 可能导致邮件被拒收或进入垃圾箱。
4. 启用日志调试，定位真实错误
在 config/mail.php 中临时添加日志驱动：
'stream' => [
'stream' => [
'timeout' => 30,
'ssl' => ['verify_peer' => false], // 仅测试用，勿用于生产
],
],并在 .env 中开启邮件日志：
MAIL_LOG_LEVEL=debug
然后执行：
php artisan tinker
>>> \Illuminate\Support\Facades\Mail::to('test@example.com')->send(new \App\Mail\TestMail());查看 storage/logs/laravel.log 中的 SMTP 连接错误（如 Connection refused, Authentication failed）。
5. 替代方案：使用可靠第三方 SMTP（推荐）
若自建邮箱持续失败，建议改用 SendGrid 或 Mailgun（免费额度充足）：
MAIL_DRIVER=smtp MAIL_HOST=smtp.sendgrid.net MAIL_PORT=587 MAIL_USERNAME=apikey MAIL_PASSWORD=SG.your_api_key_here MAIL_ENCRYPTION=tls
✅ 优势：免 DNS 配置、高送达率、详细发信日志、Web 控制台实时监控。
? 最终验证清单
- [ ] APP_ENV=production 且 APP_DEBUG=false
- [ ] MAIL_DRIVER=smtp（非 mail）
- [ ] MAIL_USERNAME 和 MAIL_PASSWORD 无引号
- [ ] MAIL_PORT 与 MAIL_ENCRYPTION 组合正确（465+ssl 或 587+tls）
- [ ] 使用 php artisan config:clear && php artisan cache:clear 清除配置缓存
- [ ] 在控制器中添加日志验证邮件是否真正触发：
\Log::info('Password reset requested for: ' . $request->email);
完成上述步骤后，密码重置邮件即可稳定送达。记住：生产环境的邮件发送不是“配置即成功”，而是“验证即可靠”——务必通过日志和第三方工具交叉验证每一步。
