Бизнес-событие должно описывать сообщение, а не API конкретного почтового сервиса. Сохраните получателя, назначение, версию шаблона и устойчивый ID сообщения, а отправку поручите отдельному транспортному адаптеру. Перед переключением разберите незавершённые попытки: таймаут старого API не доказывает, что провайдер не принял письмо.
Symfony Mailer показывает такой подход через транспорты для разных способов доставки; документация проверена 21 октября 2026 года. Это полезное разделение ответственности, но не обещание одинаковых гарантий у всех провайдеров. Поддержку вложений, меток, событий и ограничений проверяют на выбранных продуктах отдельно.
Контракт, который не знает имя поставщика
Условная запись сообщения:
message_id: устойчивый ID приложения
purpose: тип уведомления
recipient: проверенный адрес
template_revision: неизменяемая редакция
payload_reference: разрешённые данные
transport_attempt: отдельный ID попытки
provider_message_id: результат принятия конкретным сервисомНе используйте provider message ID как единственную идентичность задачи. После миграции у новой попытки будет другой внешний идентификатор, хотя бизнес-уведомление осталось прежним. Связь нужна и для поздних событий от старого сервиса: их следует сопоставлять с прежними попытками, а не автоматически относить к новой отправке.
Три исхода определяют переход
| Исход попытки | Действие приложения |
|---|---|
| Сервис подтвердил принятие | Сохранить внешний ID и ждать доступные события |
| Документированный отказ до принятия | Решить, допустим ли повтор или смена маршрута |
| Ответ потерян, исход неизвестен | Сверить состояние по возможностям провайдера, не отправлять вслепую |
Автоматический failover удобен, но требует понимания границы отказа. Если первый сервис уже принял письмо, мгновенная отправка через второй способна создать дубль. Когда API не позволяет надёжно выяснить исход, это ограничение продукта должно быть явным. Единой волшебной настройки доставки «ровно один раз» для произвольной пары сервисов нет.
Нормализуйте внешние статусы в собственные события с сохранением происхождения. Принято, передано получающему серверу, окончательно отклонено и прочитано — разные сведения; доступность каждого зависит от провайдера. Не называйте успешный HTTP-запрос доказательством попадания во входящие. События после миграции могут прийти с задержкой и повторно.
Переключайте новые задачи, а старые завершайте явно
- Собрать контракт и контрольные сообщения без клиентских данных.
- Проверить новый сервис на разрешённых тестовых получателях.
- Выделить ограниченный маршрут для новых сообщений.
- Зафиксировать, какой транспорт назначен каждой задаче.
- Сохранить приём событий старого провайдера до завершения его попыток.
Отдельно проверьте домены отправителя, подписи, адрес ответа и технические возвраты по документации нового сервиса. Не копируйте секреты в payload очереди: адаптер получает их из принятого хранилища конфигурации. Массовую двойную отправку реальным клиентам нельзя использовать как теневой тест двух транспортов.
При откате меняйте маршрут новых задач и сохраняйте историю уже принятых попыток. Затем проверьте потерю ответа, повтор события и поздний bounce старого сервиса. Для миграции подготовьте таблицу возможностей двух провайдеров и правила неопределённого исхода. Тогда смена поставщика затронет доставку и наблюдение, а не логику создания заказа или подтверждения регистрации.