Laravel 9 SMTP服务器认证失败求助（无代码变更仍报错）

问题描述 #

• 使用用户名b926ad2c64b4a7通过CRAM-MD5、LOGIN、PLAIN认证器连接SMTP服务器时均认证失败：CRAM-MD5返回错误码451（内部服务器错误），LOGIN和PLAIN返回空响应码。
• 项目此前运行正常，未做任何代码变更；当前环境为Laravel + Vite（npm run dev）+ Docker容器。
• 已尝试操作：
  • 更新.env中的SMTP配置为：

    MAIL_MAILER=smtp
    MAIL_HOST=smtp.mailtrap.io
    MAIL_PORT=2525
    MAIL_USERNAME=b926ad2c64b4a7
    MAIL_PASSWORD=ba6651bbf8xxxx
    MAIL_ENCRYPTION=tls
    

  • 重启Vite，执行docker compose down/up刷新容器
  • 运行命令：

    php artisan config:cache
    php artisan config:clear
    php artisan cache:clear
    

• 问题：上述操作后仍无法完成SMTP认证，请求技术解决。

排查与解决步骤 #

1. 验证Mailtrap凭据有效性 #

• 登录Mailtrap后台，确认当前使用的MAIL_USERNAME和MAIL_PASSWORD对应活跃的收件箱，无过期或禁用情况。
• 用原生PHP代码直接测试SMTP连接，排除Laravel框架层面问题：

  $smtp = fsockopen('smtp.mailtrap.io', 2525, $errno, $errstr, 30);
  if (!$smtp) {
      echo "$errstr ($errno)";
  } else {
      fwrite($smtp, "EHLO localhost\r\n");
      echo fread($smtp, 1024);
      fwrite($smtp, "AUTH LOGIN\r\n");
      echo fread($smtp, 1024);
      fwrite($smtp, base64_encode('b926ad2c64b4a7') . "\r\n");
      echo fread($smtp, 1024);
      fwrite($smtp, base64_encode('ba6651bbf8xxxx') . "\r\n");
      echo fread($smtp, 1024);
      fclose($smtp);
  }
  

  执行后查看输出，确认是否能正常通过认证。

2. 检查Docker容器网络连通性 #

• 进入Laravel容器，执行ping测试解析能力：

  ping smtp.mailtrap.io
  

• 用telnet测试端口连通性：

  telnet smtp.mailtrap.io 2525
  

  若无法连接，检查Docker网络配置（如自定义网络规则、宿主机防火墙是否阻止2525端口）。

3. 强制Laravel使用指定认证器 #

Laravel默认会尝试多种认证器，可在config/mail.php中指定仅使用LOGIN模式，规避CRAM-MD5的问题：

'mailers' => [
    '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' => 'login', // 强制指定认证模式
    ],
    // 其他邮件驱动配置
],

修改后执行php artisan config:clear，再测试邮件发送。

4. 查看Laravel日志细节 #

检查storage/logs/laravel.log中的完整错误信息，定位具体失败原因（如SSL证书问题、凭据传递错误等）。

5. 确认容器是否正确读取.env配置 #

• 进入Docker容器，验证.env内容：

  cat .env | grep MAIL_
  

• 用tinker确认环境变量读取情况：

  php artisan tinker
  echo env('MAIL_USERNAME')
  

  若输出异常，检查Docker-compose.yml中是否正确挂载.env文件，或是否存在环境变量覆盖配置。

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