Laravel用Mailtrap发信正常，Gmail/Outlook等第三方邮箱超时无响应

问题描述 #

使用Laravel发送邮件时，Mailtrap配置可正常工作，但切换至Gmail、Outlook、Namecheap邮箱的SMTP配置后，页面持续加载直至超时，无任何响应代码。

配置信息 #

Gmail SMTP配置（已使用应用密码） #

MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=465
MAIL_USERNAME=myemail@gmail.com 
MAIL_PASSWORD=*************
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=myemail@gmail.com
MAIL_FROM_NAME="${APP_NAME}"

Namecheap SMTP配置 #

MAIL_MAILER=smtp
MAIL_HOST=mail.privateemail.com
MAIL_PORT=587
MAIL_USERNAME=mail@myemail.com
MAIL_PASSWORD=*************
MAIL_ENCRYPTION=TLS
MAIL_FROM_ADDRESS=mail@myemail.com
MAIL_FROM_NAME="${APP_NAME}"

Mailtrap配置（正常可用） #

MAIL_MAILER=smtp
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=*********
MAIL_PASSWORD=**********
MAIL_ENCRYPTION=tls

排查与解决步骤 #

1. 检查服务器出站端口是否被封禁 #

Mailtrap使用2525端口通常不受限制，但Gmail（465/587）、Namecheap（587）、Outlook（587）的常用SMTP端口可能被服务器提供商默认封禁。

• 在服务器终端执行以下命令测试端口连通性：

  # 测试Gmail 465端口
  telnet smtp.gmail.com 465
  # 或用nc命令（若telnet未安装）
  nc -zv smtp.gmail.com 465
  
  # 测试Namecheap 587端口
  nc -zv mail.privateemail.com 587
  

• 如果连接失败（提示Connection refused或超时），联系服务器服务商开放对应端口，或检查服务器防火墙（如iptables、ufw）规则。

2. 修正配置细节 #

• 加密协议大小写：Laravel的MAIL_ENCRYPTION字段建议使用小写tls，避免大写TLS可能导致的解析问题，将Namecheap配置中的MAIL_ENCRYPTION=TLS改为MAIL_ENCRYPTION=tls。
• 环境变量引用格式：MAIL_FROM_NAME中的${APP_NAME}在.env文件中需用双引号包裹，确保变量能正确解析，保持配置中的"${APP_NAME}"格式即可。
• Outlook配置补充：Outlook的正确SMTP配置为：

  MAIL_HOST=smtp.office365.com
  MAIL_PORT=587
  MAIL_ENCRYPTION=tls
  

  确认使用完整的Outlook邮箱地址作为MAIL_USERNAME和MAIL_FROM_ADDRESS。

3. 启用邮件队列异步发送 #

同步发送邮件时，Laravel会等待SMTP服务器响应，若网络延迟高则直接导致页面超时。启用队列异步处理可避免此问题：

1. 配置队列驱动（以database为例）：

   QUEUE_CONNECTION=database
   

2. 生成队列所需数据表：

   php artisan queue:table
   php artisan migrate
   

3. 将邮件发送逻辑改为队列任务：

   // 原同步发送
   // Mail::to($user)->send(new WelcomeMail());
   
   // 改为队列异步发送
   Mail::to($user)->queue(new WelcomeMail());
   

4. 启动队列处理器：

   php artisan queue:work
   

   建议使用Supervisor等工具维持队列进程长期运行。

4. 调试SMTP连接日志 #

开启Laravel的详细日志，查看邮件发送时的具体错误：

1. 在.env中开启调试模式：

   APP_DEBUG=true
   

2. 查看storage/logs/laravel.log文件，搜索Swift_TransportException或Mail相关日志，获取具体的连接错误信息。

5. 特殊情况处理（Gmail） #

• 若服务器位于国内，直接连接Gmail SMTP可能被网络限制，可尝试使用587端口+TLS加密，或更换为国内可用的邮箱服务商（如QQ邮箱、网易邮箱）。
• 确认谷歌账号已开启「两步验证」，且应用密码是在开启两步验证后生成的。

内容的提问来源于stack exchange，提问作者Dev Pot