Laravel 11 SMTP配置异常：邮件验证无法发送邮件求助

核心结论：log驱动正常说明邮件业务逻辑没问题，问题出在SMTP 465端口的连接配置或环境限制上，按以下步骤逐一排查：

• 配置.env文件（严格对应465 SSL要求）
  确保配置项完全匹配服务商要求，别混淆加密方式和端口：

  MAIL_MAILER=smtp
  MAIL_HOST=你的SMTP服务器地址（如smtp.xxx.com）
  MAIL_PORT=465
  MAIL_USERNAME=你的完整邮箱账号
  MAIL_PASSWORD=服务商提供的SMTP授权码（注意：不是邮箱登录密码，多数服务商需要单独生成授权码）
  MAIL_ENCRYPTION=ssl
  MAIL_FROM_ADDRESS=与MAIL_USERNAME一致的邮箱
  MAIL_FROM_NAME="你的站点名称"
  

• 强制清除配置缓存
  Laravel会缓存.env配置，修改后必须执行以下命令生效：

  php artisan config:clear
  php artisan cache:clear
  

• 用Laravel自带逻辑捕获具体错误
  第三方测试工具的环境和你的服务器环境不一致，直接在项目中写测试路由获取精准报错：
  在routes/web.php中添加：

  Route::get('/test-smtp', function () {
      try {
          \Illuminate\Support\Facades\Mail::raw('SMTP测试内容', function ($msg) {
              $msg->to('你的个人测试邮箱')->subject('Laravel SMTP测试');
          });
          return '邮件发送成功！';
      } catch (\Exception $e) {
          return '错误详情：' . $e->getMessage();
      }
  });
  

  访问该路由，根据报错信息定位问题（如证书不被信任、授权码错误、端口被屏蔽等）。

• 检查服务器防火墙/安全组
  多数云服务器（阿里云、腾讯云等）默认屏蔽出站465端口，需在服务器控制台的安全组规则中，添加出站方向的TCP 465端口放行。

• 处理SSL证书信任问题
  如果报错涉及SSL证书（如SSL certificate problem: unable to get local issuer certificate），可临时在config/mail.php的smtp配置中添加两行（长期建议安装信任根证书）：

  'smtp' => [
      'transport' => 'smtp',
      'host' => env('MAIL_HOST', 'smtp.mailgun.org'),
      'port' => env('MAIL_PORT', 587),
      'encryption' => env('MAIL_ENCRYPTION', 'tls'),
      'username' => env('MAIL_USERNAME'),
      'password' => env('MAIL_PASSWORD'),
      'timeout' => null,
      'auth_mode' => null,
      // 新增以下两行
      'verify_peer' => false,
      'verify_peer_name' => false,
  ],
  

• 再次确认服务商SMTP细节
  核对以下服务商要求：

  • 是否在邮箱后台开启了SMTP服务？
  • 授权码是否为正确生成的（如QQ邮箱需在设置页面单独生成）？
  • 是否有IP白名单限制？若有需将服务器IP加入白名单。

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