SwiftMailer迁移至独立Symfony Mailer失败问题排查

数据老陈

2026-7-11

问题原因与解决方案

核心差异分析

SwiftMailer 和 Symfony Mailer 在端口25的SMTP处理逻辑上存在关键区别：

SwiftMailer：Swift_SmtpTransport 在端口25下默认不会主动触发STARTTLS，仅当服务器明确提供STARTTLS扩展时才可选启用，且不会强制SSL验证。
Symfony Mailer：EsmtpTransport 默认会自动尝试STARTTLS握手，当你的邮件服务器使用未被PHP信任的CA证书（比如自签名证书）时，就会触发日志中的unknown ca错误，导致连接中断。

解决方案

方案1：禁用STARTTLS（适配端口25的明文SMTP场景）

修改Symfony Mailer的初始化代码，显式禁用STARTTLS：

$this->mailer = new \Symfony\Component\Mailer\Mailer(
    (new \Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport(
        env('MAIL_HOST'),
        (int)env('MAIL_PORT'),
        false // 第三个参数设为false，禁用STARTTLS
    ))
        ->setUsername(env('MAIL_USERNAME'))
        ->setPassword(env('MAIL_PASSWORD'))
);

方案2：信任服务器CA证书（如需保留TLS加密）

如果服务器确实需要STARTTLS，可配置PHP信任服务器的CA证书：

$transport = (new \Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport(
    env('MAIL_HOST'),
    (int)env('MAIL_PORT')
))
    ->setUsername(env('MAIL_USERNAME'))
    ->setPassword(env('MAIL_PASSWORD'));

// 获取底层Stream配置，添加CA证书路径
$streamOptions = $transport->getStream()->getOptions();
$streamOptions['ssl']['cafile'] = '/path/to/your/server/ca.crt'; // 替换为实际CA证书路径
$transport->getStream()->setOptions($streamOptions);

$this->mailer = new \Symfony\Component\Mailer\Mailer($transport);