如何从Yii2 symfonymailer获取邮件发送失败的错误信息？

yii2-symfonymailer底层基于Symfony Mailer，默认send()方法失败时仅返回false，不会主动抛出异常。要获取具体错误信息，可通过以下两种方式实现：

方法一：开启异常抛出（推荐） #

通过配置邮件组件的throwException属性为true，让发送失败时直接抛出异常，捕获后即可获取详细错误信息。

1. 修改组件配置 #

在项目配置文件（如config/web.php或config/main.php）的components节点下添加或修改mailer配置：

'components' => [
    'mailer' => [
        'class' => \yii\symfonymailer\Mailer::class,
        'transport' => [
            'dsn' => 'smtp://your_username:your_password@smtp.example.com:587',
        ],
        'throwException' => true, // 开启异常抛出
    ],
],

2. 在代码中捕获异常 #

使用try-catch块捕获Symfony邮件相关异常，获取错误详情：

try {
    $message = Yii::$app->mailer->compose()
        ->setFrom('from@domain.com')
        ->setTo('to@domain.com')
        ->setSubject('Message subject')
        ->setTextBody('Plain text content')
        ->setHtmlBody('<b>HTML content</b>');
    
    $message->send();
} catch (\Symfony\Component\Mailer\Exception\TransportExceptionInterface $e) {
    // 获取错误信息
    $errorMsg = $e->getMessage();
    // 可进一步获取原始错误（如SMTP层的错误）
    if ($previousErr = $e->getPrevious()) {
        $errorMsg .= " | 原始错误：{$previousErr->getMessage()}";
    }
    
    // 处理错误，例如记录日志
    Yii::error("邮件发送失败：{$errorMsg}", __METHOD__);
}

所有邮件发送相关的异常（如认证失败、连接超时、收件人无效等）均实现了TransportExceptionInterface接口，捕获该接口即可覆盖所有场景。

方法二：获取最后异常（无需修改配置） #

Yii2的BaseMailer类会将发送失败时的异常存储在protected属性lastException中，可通过反射机制读取该属性：

$message = Yii::$app->mailer->compose()
    ->setFrom('from@domain.com')
    ->setTo('to@domain.com')
    ->setSubject('Message subject')
    ->setTextBody('Plain text content')
    ->setHtmlBody('<b>HTML content</b>');

if (!$message->send()) {
    $mailer = Yii::$app->mailer;
    // 通过反射访问protected属性
    $reflection = new \ReflectionClass($mailer);
    $lastExceptionProp = $reflection->getProperty('lastException');
    $lastExceptionProp->setAccessible(true);
    $exception = $lastExceptionProp->getValue($mailer);
    
    if ($exception instanceof \Symfony\Component\Mailer\Exception\TransportExceptionInterface) {
        $errorMsg = $exception->getMessage();
        // 处理错误
        Yii::error("邮件发送失败：{$errorMsg}", __METHOD__);
    }
}

注意：该方法依赖反射，代码相对繁琐，仅推荐在无法修改组件配置的场景下使用。

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