Тестирование писем в CI/CD через Mailpit: перехват SMTP без реальной отправки

Почему реальная отправка в CI — это баг, а не фича

Сценарий, который повторяется в каждой второй кодовой базе. В фикстуре welcome-письма жёстко зашит [email protected], кто-то меняет его на свой рабочий адрес для отладки, забывает откатить — и с этого момента каждый прогон интеграционных тестов на CI шлёт живому человеку «Добро пожаловать в сервис». Дальше веселее: тест дёргает внешний SMTP, релей включает greylisting, первая попытка отбивается 450 4.2.0, тест флакает через раз, команда добавляет sleep 5 и ретраи, зелёный билд превращается в лотерею. А в CI-секретах при этом лежит логин и пароль от продового релея — потому что «ну надо же куда-то отправлять».

И самое обидное: сломанный <table>-лейаут, поехавший в Outlook, всё это не ловит. Он всплывает в проде, когда письмо уже ушло десяти тысячам подписчиков.

Корень проблемы в том, что письмо воспринимают как побочный эффект, а не как артефакт сборки. API-ответ вы проверяете ассертами по схеме, а письмо — «глазами после деплоя». Лечится это одним архитектурным решением: в пайплайн ставится SMTP-сток — процесс, который принимает любое соединение на порту 1025, складывает письмо в память или SQLite и отдаёт его тестам по HTTP. Ноль исходящего трафика с раннера. Приложение думает, что отправило письмо; на деле оно попало в ловушку, где его можно распотрошить и проверить.