vendor/symfony/messenger/EventListener/SendFailedMessageForRetryListener.php line 51

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Messenger\EventListener;
  14. use Psr\Container\ContainerInterface;
  15. use Psr\EventDispatcher\EventDispatcherInterface;
  16. use Psr\Log\LoggerInterface;
  17. use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  18. use Symfony\Component\Messenger\Envelope;
  19. use Symfony\Component\Messenger\Event\WorkerMessageFailedEvent;
  20. use Symfony\Component\Messenger\Event\WorkerMessageRetriedEvent;
  21. use Symfony\Component\Messenger\Exception\HandlerFailedException;
  22. use Symfony\Component\Messenger\Exception\RecoverableExceptionInterface;
  23. use Symfony\Component\Messenger\Exception\RuntimeException;
  24. use Symfony\Component\Messenger\Exception\UnrecoverableExceptionInterface;
  25. use Symfony\Component\Messenger\Retry\RetryStrategyInterface;
  26. use Symfony\Component\Messenger\Stamp\DelayStamp;
  27. use Symfony\Component\Messenger\Stamp\RedeliveryStamp;
  28. use Symfony\Component\Messenger\Stamp\StampInterface;
  29. use Symfony\Component\Messenger\Transport\Sender\SenderInterface;
  31. /**
  32.  * @author Tobias Schultze <http://tobion.de>
  33.  */
  34. class SendFailedMessageForRetryListener implements EventSubscriberInterface
  35. {
  36.     private ContainerInterface $sendersLocator;
  37.     private ContainerInterface $retryStrategyLocator;
  38.     private ?LoggerInterface $logger;
  39.     private ?EventDispatcherInterface $eventDispatcher;
  40.     private int $historySize;
  42.     public function __construct(ContainerInterface $sendersLocator, ContainerInterface $retryStrategyLocator, LoggerInterface $logger = null, EventDispatcherInterface $eventDispatcher = null, int $historySize = 10)
  43.     {
  44.         $this->sendersLocator = $sendersLocator;
  45.         $this->retryStrategyLocator = $retryStrategyLocator;
  46.         $this->logger = $logger;
  47.         $this->eventDispatcher = $eventDispatcher;
  48.         $this->historySize = $historySize;
  49.     }
  51.     public function onMessageFailed(WorkerMessageFailedEvent $event)
  52.     {
  53.         $retryStrategy = $this->getRetryStrategyForTransport($event->getReceiverName());
  54.         $envelope = $event->getEnvelope();
  55.         $throwable = $event->getThrowable();
  57.         $message = $envelope->getMessage();
  58.         $context = [
  59.             'class' => $message::class,
  60.         ];
  62.         $shouldRetry = $retryStrategy && $this->shouldRetry($throwable, $envelope, $retryStrategy);
  64.         $retryCount = RedeliveryStamp::getRetryCountFromEnvelope($envelope);
  65.         if ($shouldRetry) {
  66.             $event->setForRetry();
  68.             ++$retryCount;
  70.             $delay = $retryStrategy->getWaitingTime($envelope, $throwable);
  72.             $this->logger?->warning('Error thrown while handling message {class}. Sending for retry #{retryCount} using {delay} ms delay. Error: "{error}"', $context + ['retryCount' => $retryCount, 'delay' => $delay, 'error' => $throwable->getMessage(), 'exception' => $throwable]);
  74.             // add the delay and retry stamp info
  75.             $retryEnvelope = $this->withLimitedHistory($envelope, new DelayStamp($delay), new RedeliveryStamp($retryCount));
  77.             // re-send the message for retry
  78.             $this->getSenderForTransport($event->getReceiverName())->send($retryEnvelope);
  80.             $this->eventDispatcher?->dispatch(new WorkerMessageRetriedEvent($retryEnvelope, $event->getReceiverName()));
  81.         } else {
  82.             $this->logger?->critical('Error thrown while handling message {class}. Removing from transport after {retryCount} retries. Error: "{error}"', $context + ['retryCount' => $retryCount, 'error' => $throwable->getMessage(), 'exception' => $throwable]);
  83.         }
  84.     }
  86.     /**
  87.      * Adds stamps to the envelope by keeping only the First + Last N stamps.
  88.      */
  89.     private function withLimitedHistory(Envelope $envelope, StampInterface ...$stamps): Envelope
  90.     {
  91.         foreach ($stamps as $stamp) {
  92.             $history = $envelope->all($stamp::class);
  93.             if (\count($history) < $this->historySize) {
  94.                 $envelope = $envelope->with($stamp);
  95.                 continue;
  96.             }
  98.             $history = array_merge(
  99.                 [$history[0]],
  100.                 \array_slice($history, -$this->historySize + 2),
  101.                 [$stamp]
  102.             );
  104.             $envelope = $envelope->withoutAll($stamp::class)->with(...$history);
  105.         }
  107.         return $envelope;
  108.     }
  110.     public static function getSubscribedEvents(): array
  111.     {
  112.         return [
  113.             // must have higher priority than SendFailedMessageToFailureTransportListener
  114.             WorkerMessageFailedEvent::class => ['onMessageFailed', 100],
  115.         ];
  116.     }
  118.     private function shouldRetry(\Throwable $e, Envelope $envelope, RetryStrategyInterface $retryStrategy): bool
  119.     {
  120.         $isRetryable = $retryStrategy->isRetryable($envelope, $e);
  121.         if ($isRetryable && $e instanceof RecoverableExceptionInterface) {
  122.             return true;
  123.         }
  125.         // if one or more nested Exceptions is an instance of RecoverableExceptionInterface we should retry
  126.         // if ALL nested Exceptions are an instance of UnrecoverableExceptionInterface we should not retry
  127.         if ($e instanceof HandlerFailedException) {
  128.             $shouldNotRetry = true;
  129.             foreach ($e->getNestedExceptions() as $nestedException) {
  130.                 if ($isRetryable && $nestedException instanceof RecoverableExceptionInterface) {
  131.                     return true;
  132.                 }
  134.                 if (!$nestedException instanceof UnrecoverableExceptionInterface) {
  135.                     $shouldNotRetry = false;
  136.                     break;
  137.                 }
  138.             }
  139.             if ($shouldNotRetry) {
  140.                 return false;
  141.             }
  142.         }
  144.         if ($e instanceof UnrecoverableExceptionInterface) {
  145.             return false;
  146.         }
  148.         return $isRetryable;
  149.     }
  151.     private function getRetryStrategyForTransport(string $alias): ?RetryStrategyInterface
  152.     {
  153.         if ($this->retryStrategyLocator->has($alias)) {
  154.             return $this->retryStrategyLocator->get($alias);
  155.         }
  157.         return null;
  158.     }
  160.     private function getSenderForTransport(string $alias): SenderInterface
  161.     {
  162.         if ($this->sendersLocator->has($alias)) {
  163.             return $this->sendersLocator->get($alias);
  164.         }
  166.         throw new RuntimeException(sprintf('Could not find sender "%s" based on the same receiver to send the failed message to for retry.', $alias));
  167.     }
  168. }