laravel 5.5 在本地使用 mailtrap 正常发送密码重置邮件，但部署到 cpanel 后失效，通常源于 smtp 配置错误、服务器限制或环境变量未正确加载，需系统性排查并切换为可靠邮件服务（如 gmail、mailgun 或 smtp 中继）。
在 Laravel 5.5 中，密码重置功能依赖 Illuminate\Auth\Passwords\PasswordBroker 和底层 Mail 服务。本地开发时通过 Mailtrap 测试成功，说明逻辑无误；而上线后收不到邮件，90% 的情况是生产环境的邮件配置未适配真实 SMTP 服务或被主机商拦截。
? 关键问题诊断
你当前 .env 中配置了自建邮箱服务器：
MAIL_DRIVER=mail MAIL_HOST="mail.dmdhakamanpower.com" MAIL_PORT="465" MAIL_USERNAME="admin@dmdhakamanpower.com" MAIL_PASSWORD=***** MAIL_ENCRYPTION="SSL"
⚠️ 注意：MAIL_DRIVER=mail 并非 SMTP 驱动，而是调用 PHP 的 mail() 函数（依赖服务器本地 sendmail/postfix），在大多数共享主机（如 cPanel）上默认禁用或不可靠，且不支持 MAIL_PORT/MAIL_ENCRYPTION 等参数——这些配置对 mail 驱动完全无效！
✅ 正确做法是将 MAIL_DRIVER 显式改为 smtp：
MAIL_DRIVER=smtp MAIL_HOST=mail.dmdhakamanpower.com MAIL_PORT=465 MAIL_USERNAME=admin@dmdhakamanpower.com MAIL_PASSWORD=your_actual_password MAIL_ENCRYPTION=ssl MAIL_FROM_ADDRESS=admin@dmdhakamanpower.com MAIL_FROM_NAME="DMD Hakaman Power"
? 提示：删除所有值周围的双引号（Laravel 5.5 的 .env 解析器不兼容带引号的字符串，尤其含 @ 或 . 时易解析失败）。
✅ 推荐：改用稳定第三方 SMTP（以 Gmail 为例）
若自建邮箱配置复杂或被 cPanel 限制（如端口 465 被封、SMTP 认证失败），强烈建议切换至 Gmail SMTP（需开启「应用专用密码」）：
MAIL_DRIVER=smtp MAIL_HOST=smtp.gmail.com MAIL_PORT=587 MAIL_USERNAME=yourname@gmail.com MAIL_PASSWORD=your_app_specific_password # ⚠️ 非登录密码！见下方说明 MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=yourname@gmail.com MAIL_FROM_NAME="Your App"
? Gmail 设置要点：
- 开启 Google 账户的「两步验证」；
- 进入 Google App Passwords 页面，生成 16 位「应用专用密码」；
- 使用该密码替代 Gmail 登录密码；
- 确保 APP_ENV=production 且 APP_DEBUG=false（避免敏感信息泄露）。
? 验证与调试步骤
-
清除配置缓存（cPanel 中务必执行）：
php artisan config:clear php artisan cache:clear
⚠️ 共享主机中 .env 修改后，若未清缓存，Laravel 仍读取旧配置！
-
测试邮件发送（命令行快速验证）：
创建测试命令：php artisan make:command TestEmail
在 app/Console/Commands/TestEmail.php 中编写：
public function handle() { \Mail::raw('Test from Laravel on cPanel!', function ($message) { $message->to('your-test@email.com')->subject('Laravel SMTP Test'); }); $this->info('Test email sent!'); }执行：php artisan test:email
检查日志：
查看 storage/logs/laravel.log，搜索 Swift_TransportException 或 Connection could not be established，定位具体错误（如 DNS 解析失败、认证拒绝、端口被拒等）。
? 最佳实践总结
| 项目 | 推荐方案 |
|---|---|
| 驱动选择 | 生产环境必须用 smtp，禁用 mail/sendmail |
| 端口与加密 | PORT=587 + ENCRYPTION=tls 更通用；465 + ssl 需确保服务器 OpenSSL 版本支持 |
| cPanel 注意事项 | 检查「Email Deliverability」设置，启用「Allow Remote SMTP」；部分主机要求使用 relay-hosting.secureserver.net（GoDaddy）或 localhost（配合本地 Postfix） |
| 安全加固 | APP_DEBUG=false，APP_ENV=production，避免 .env 文件被 Web 直接访问 |
完成上述配置并清缓存后，密码重置流程即可恢复正常。如仍失败，请联系主机商确认是否屏蔽了出站 SMTP 流量，或直接选用 Mailgun / SendGrid（提供免费额度及完善 API 日志），它们与 Laravel 集成简单且可靠性极高。
