Issue Bug Under Review Quiet

#110173Spooled sending of emails fails with PHP TypeError for HttpTransports

Stephan Großberndt 07/08/26, 13:21 updated 10/07/26, 07:32

Description

When 'transport_spool_type' => 'memory', or 'transport_spool_type' => 'file', is set (see https://docs.typo3.org/permalink/t3coreapi:confval-globals-typo3-conf-vars-mail-transport-spool-type) and mail is sent via a 3rd party transport via dsn (see https://docs.typo3.org/permalink/t3coreapi:confval-globals-typo3-conf-vars-mail-dsn)
a PHP error occurs on sending the mail from spool:


(1/1) TypeError

Symfony\Component\Mime\MessageConverter::toEmail(): Argument #1 ($message) must be of type Symfony\Component\Mime\Message, Symfony\Component\Mime\RawMessage given, called in vendor/symfony/mailer/Transport/AbstractApiTransport.php on line 33
in vendor/symfony/mime/MessageConverter.php line 29

{
    /**
     * @throws RuntimeException when unable to convert the message to an email
     */
    public static function toEmail(Message $message): Email
    {
        if ($message instanceof Email) {
            return $message;
        }

at Symfony\Component\Mime\MessageConverter::toEmail()
in vendor/symfony/mailer/Transport/AbstractApiTransport.php line 33

    protected function doSendHttp(SentMessage $message): ResponseInterface
    {
        try {
            $email = MessageConverter::toEmail($message->getOriginalMessage());
        } catch (\Exception $e) {
            throw new RuntimeException(\sprintf('Unable to send message with the "%s" transport: ', __CLASS__).$e->getMessage(), 0, $e);
        }

at Symfony\Component\Mailer\Transport\AbstractApiTransport->doSendHttp()
in vendor/symfony/mailer/Transport/AbstractHttpTransport.php line 71

    protected function doSend(SentMessage $message): void
    {
        try {
            $response = $this->doSendHttp($message);
            $message->appendDebug($response->getInfo('debug') ?? '');
        } catch (HttpTransportException $e) {
            $e->appendDebug($e->getResponse()->getInfo('debug') ?? '');

at Symfony\Component\Mailer\Transport\AbstractHttpTransport->doSend()
in vendor/symfony/mailer/Transport/AbstractTransport.php line 90

            $sentMessage = new SentMessage($message, $envelope);

            try {
                $this->doSend($sentMessage);
            } catch (\Throwable $error) {
                $this->dispatcher->dispatch(new FailedMessageEvent($message, $error));
                $this->checkThrottling();

at Symfony\Component\Mailer\Transport\AbstractTransport->send()
in vendor/typo3/cms-core/Classes/Mail/FileSpool.php line 172

                }
                if ($message instanceof SentMessage) {
                    // This may throw an exception if something goes wrong.
                    // That is expected and will cause the `.sending` file to remain within the spooler.
                    $transport->send($message->getMessage(), $message->getEnvelope());
                    $count++;
                    unlink($file . '.sending');
                } else {
                    $this->logger?->error(

at TYPO3\CMS\Core\Mail\FileSpool->flushQueue()
in vendor/typo3/cms-core/Classes/Command/SendEmailCommand.php line 72

                } else {
                    $transport->recover();
                }
            }
            $sent = $transport->flushQueue($mailer->getRealTransport());
            $io->comment($sent . ' emails sent');
            return Command::SUCCESS;
        }
        $io->error('The Mailer Transport is not set to "spool".');

This does only happen for the combination of a HTTP transport and activated spooling. Spooled SMTP works, HTTP without spooling works.

MessageConverter::toEmail() expects a Symfony\Component\Mime\Message, but receives a Symfony\Component\Mime\RawMessage from both spoolers (file/memory) in $transport->send($message->getMessage(), $message->getEnvelope());, as SentMessage::getMessage() returns the RawMessage: https://github.com/symfony/mailer/blob/8.2/SentMessage.php#L53

Both spoolers must use $message->getOriginalMessage() instead.

Reviews 5

Linked, but not in Forger: Change 94844

History 518

  1. Stephan Großberndt changed subject Spooled sending of emails fails with PHP `TypeError` for `HttpTransport`s Spooled sending of emails fails with PHP TypeError for HttpTransports <span data-processor="relativetime" data-value="2026-07-08T13:21:22+00:00" > 07/08/26, 13:21 </span>

  2. Stephan Großberndt commented <span data-processor="relativetime" data-value="2026-07-08T14:32:18+00:00" > 07/08/26, 14:32 </span>

    We found that error when using https://github.com/symfony/microsoft-graph-mailer in combination with 'transport_spool_type' => 'file'

    How to reproduce:

    composer require symfony/microsoft-graph-mailer
    $GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport'] = 'dsn';
    $GLOBALS['TYPO3_CONF_VARS']['MAIL']['dsn'] = 'microsoftgraph+api://CLIENT_APP_ID:CLIENT_APP_SECRET@default?tenantId=TENANT_ID';
    $GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_spool_type'] = 'file';