Laravel 10使用EsmtpTransport测试TLS邮件连接失败求助

问题根源 #

报错信息 ssl://smtp.gmail.com:587": stream_socket_client(): SSL operation failed with code 1 的核心原因是：587端口是STARTTLS专用端口，需要先建立明文TCP连接，再通过STARTTLS命令升级为加密连接，而你的代码中错误地使用了ssl://前缀直接发起SSL握手，导致服务器返回版本不匹配的错误。

解决方案 #

1. 纠正EsmtpTransport初始化逻辑 #

EsmtpTransport的第三个$tls参数表示是否启用STARTTLS协议，而非直接使用SSL包装连接。确保你的变量映射逻辑正确：

$encryption = Setting::where('key', 'email_encryption')->firstOrFail()->value;
// 统一转小写避免大小写问题，启用STARTTLS
$useStartTls = strtolower($encryption) === 'tls';

// 初始化Transport：第三个参数传true表示启用STARTTLS流程
$transport = new EsmtpTransport($host, $port, $useStartTls);
$transport->setUsername($username);
$transport->setPassword($password);

2. 显式配置SSL上下文选项（可选） #

如果仍存在SSL握手兼容问题，可以指定TLS版本及证书验证规则：

$transport->setStreamOptions([
    'ssl' => [
        'verify_peer' => true,
        'verify_peer_name' => true,
        // 强制使用TLS 1.2/1.3，避免老旧协议报错
        'crypto_method' => STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT | STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT,
        'cafile' => openssl_get_cert_locations()['default_cert_file'],
    ],
]);

3. 验证Gmail账号配置 #

确保你的Gmail账号满足以下要求：

• 已开启两步验证
• 使用的是应用密码（而非普通账号密码）
• 无需开启"低安全性应用访问"（两步验证开启后该选项会被隐藏）

4. 改用Laravel原生Mail配置（推荐） #

Laravel 10内置了SMTP连接的可靠封装，直接在config/mail.php中配置更省心：

// config/mail.php
'mailers' => [
    'smtp' => [
        'transport' => 'smtp',
        'host' => Setting::where('key', 'email_host')->value(),
        'port' => Setting::where('key', 'email_port')->value(),
        'encryption' => Setting::where('key', 'email_encryption')->value(),
        'username' => Setting::where('key', 'email_username')->value(),
        'password' => Setting::where('key', 'email_password')->value(),
        'timeout' => 30,
    ],
],

通过Laravel Mail facade测试连接：

use Illuminate\Support\Facades\Mail;

try {
    Mail::raw('TLS连接测试', function ($message) {
        $message->to('test@example.com')->subject('测试邮件');
    });
    echo '连接成功';
} catch (\Exception $e) {
    dd($e->getMessage());
}

排查要点 #

• 确认email_encryption配置值确实为tls（注意大小写）
• 检查PHP的openssl扩展是否启用（通过phpinfo()查看）
• 验证服务器防火墙是否允许587端口的出站TCP连接

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