如何在SwiftMailer中获取邮件投递失败的具体原因？

你提的这个问题确实戳中了SwiftMailer的一个小痛点——默认的send()方法只返回失败的收件人列表，不会附带具体的拒绝原因。不过别担心，还是有办法拿到这些细节的，下面给你拆解两种可行的方案：

方案1：使用事件监听器（推荐） #

SwiftMailer内置了事件系统，可以监听发送过程中抛出的传输异常，从而捕获具体的失败原因。你可以自定义一个事件监听器，监听Swift_Events_TransportExceptionEvent事件，这个事件会携带完整的异常信息和对应的邮件对象（包含收件人）。

示例代码如下：

// 自定义事件监听器，用于跟踪失败详情
class FailureDetailListener implements Swift_Events_TransportExceptionListener
{
    private $failureDetails = [];

    // 获取带原因的失败列表
    public function getFailureDetails()
    {
        return $this->failureDetails;
    }

    public function exceptionThrown(Swift_Events_TransportExceptionEvent $event)
    {
        // 获取具体的异常信息（包含SMTP错误码和描述）
        $errorMsg = $event->getException()->getMessage();
        // 获取当前邮件的所有收件人（To/Cc/Bcc）
        $recipients = array_merge(
            array_keys($event->getMessage()->getTo() ?? []),
            array_keys($event->getMessage()->getCc() ?? []),
            array_keys($event->getMessage()->getBcc() ?? [])
        );

        // 记录每个收件人的失败原因
        foreach ($recipients as $address) {
            $this->failureDetails[$address] = $errorMsg;
        }
    }
}

// 注册监听器到Mailer实例
$listener = new FailureDetailListener();
$mailer->registerPlugin($listener);

// 执行发送
$mailer->send($message, $failures);

// 获取详细失败信息
$detailedFailures = $listener->getFailureDetails();
if (!empty($detailedFailures)) {
    echo "投递失败详情：\n";
    foreach ($detailedFailures as $email => $reason) {
        echo "{$email}: {$reason}\n";
    }
}

这个方法的优势是完全遵循SwiftMailer的设计模式，不需要修改核心逻辑，就能精准捕获每个投递失败的具体原因（比如SMTP 550表示收件人不存在，552表示邮箱存储空间不足等）。

方案2：自定义传输层（进阶） #

如果你需要更深度的定制，可以继承SwiftMailer的传输类（比如Swift_SmtpTransport），重写发送方法，在捕获异常时保存详细信息。

示例代码：

class DetailedSmtpTransport extends Swift_SmtpTransport
{
    public $failureDetails = [];

    protected function _send(Swift_Mime_SimpleMessage $message, &$failedRecipients = null)
    {
        try {
            // 调用父类的发送逻辑
            parent::_send($message, $failedRecipients);
        } catch (Swift_TransportException $e) {
            // 记录异常信息和对应收件人
            $allRecipients = array_merge(
                array_keys($message->getTo() ?? []),
                array_keys($message->getCc() ?? []),
                array_keys($message->getBcc() ?? [])
            );
            
            foreach ($allRecipients as $address) {
                $this->failureDetails[$address] = $e->getMessage();
            }

            // 保持原有逻辑：更新失败收件人列表
            if (is_array($failedRecipients)) {
                $failedRecipients = array_unique(array_merge($failedRecipients, $allRecipients));
            }

            // 可选：是否继续抛出异常，根据业务需求决定
            throw $e;
        }
    }
}

// 使用自定义传输层创建Mailer
$transport = new DetailedSmtpTransport('smtp.yourserver.com', 587);
$transport->setUsername('your_email@example.com');
$transport->setPassword('your_password');

$mailer = new Swift_Mailer($transport);

try {
    $mailer->send($message, $failures);
} catch (Swift_TransportException $e) {
    // 处理全局异常
}

// 获取详细失败信息
$detailedFailures = $transport->failureDetails;

这个方案适合需要对传输过程做更多定制的场景，但代码量相对大一些。

关于你提到的源码细节 #

你观察得很准确：默认的send()方法内部确实会捕获Swift_TransportException，但只将失败的收件人地址存入$failedRecipients，异常信息并没有被保存下来。这是因为SwiftMailer的设计初衷是让send()方法保持简洁，把更细致的错误处理交给事件系统或自定义扩展来实现，避免API过于臃肿。

所以不是做不到，只是默认没有提供直接的API，通过上面两种方案就能拿到你需要的具体失败原因啦。

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