Начните с одного пользователя и одного времени регистрации. В базе найдите событие `user_registered`, задачу очереди и provider message ID. Если ID провайдера нет, письмо потерялось внутри приложения. Если он есть, смотрите `delivery`, `bounce`, `reject` или `delivery delay`, а не строку «отправлено» в вашем интерфейсе.
Повторную отправку делайте только после фиксации этой цепочки. Иначе несколько воркеров выпустят несколько писем и ссылок, пользователь откроет старую, а журнал превратится в набор несвязанных попыток. Безопасный resend создаёт новую попытку, инвалидирует или логически заменяет предыдущий токен и сохраняет связь с тем же аккаунтом.
Почтовая цепочка имеет пять разных состояний
| Состояние | Где подтверждается | Что означает |
|---|---|---|
| event created | таблица outbox/доменное событие | регистрация решила отправить письмо |
| job processed | журнал worker и attempt | шаблон собран, вызов провайдера выполнен |
| accepted | provider message ID | провайдер принял запрос, но inbox ещё не подтверждён |
| delivery/bounce/delay | webhook или event publishing | результат передачи принимающему серверу |
| confirmed | одноразовый token consume в приложении | пользователь действительно завершил подтверждение |
Amazon SES возвращает message ID после успешного принятия и рекомендует хранить собственное соответствие между ним и вашей сущностью. Delivery в SES означает передачу серверу получателя, а не гарантированное попадание во вкладку «Входящие» и не прочтение. Bounce, complaint, reject и delivery delay — отдельные события, которые нужно принимать и связывать с попыткой.
Outbox не даёт регистрации и письму разойтись
Если пользователь записан в базу, а постановка письма в очередь выполняется отдельной операцией, сбой между ними оставляет аккаунт без задачи. Практичный вариант — transactional outbox: в одной транзакции создаются пользователь и событие, а отдельный worker забирает его с блокировкой. Повтор обработки безопасен благодаря уникальному ключу события.
registration_id: reg_01J...
user_id: 48152
event_type: confirmation_requested
attempt: 1
provider_message_id: 010201...
status: accepted
created_at_utc: 2026-10-07T10:27:14Z- Уникальный ключ не позволяет двум worker отправить одну и ту же попытку одновременно.
- Шаблон получает уже сохранённые locale и callback URL, а не читает плавающие значения из формы.
- Сбой провайдера переводит attempt в retryable или permanent failure с точным кодом.
- Адрес в логах маскируется; токен и полная ссылка подтверждения не журналируются.
Ссылка подтверждения переживает resend предсказуемо
Токен должен быть случайным, одноразовым, ограниченным по времени и связанным с конкретным назначением. В базе достаточно хранить его хеш и метаданные выпуска. При resend выберите одну модель: старые токены сразу отзываются либо все ранее выпущенные ссылки ведут к одной идемпотентной операции до общего срока. Пользователь не должен получить «неверный токен» только потому, что открыл предпоследнее письмо через минуту.
consume(token):
record = find_by_hash(sha256(token))
require record.purpose == 'confirm_email'
require record.expires_at > now_utc
if user.email_confirmed: return success
mark user confirmed and token consumed in one transactionОтвет на запрос resend не раскрывает существование адреса. Сервер ограничивает частоту по аккаунту, адресу и источнику, а интерфейс сообщает одинаковое: если адрес подходит, письмо будет отправлено. Это снижает риск перечисления пользователей и не даёт форме генерировать почтовую лавину.
SPF, DKIM и DMARC проверяются на реальном сообщении
Gmail требует аутентификацию отправителей; для direct mail домен в `From:` должен быть согласован с доменом SPF или DKIM для прохождения DMARC. Проверять нужно не только наличие DNS-записей, но и заголовки конкретного доставленного тестового письма: `Authentication-Results`, `Return-Path`, `From`, DKIM selector и домен ссылки.
Не меняйте одновременно sender, DNS и шаблон: исчезнет понимание причины. Сначала подтвердите верифицированную identity у провайдера и результат SPF/DKIM/DMARC, затем отдельно оценивайте репутацию и содержание. Для служебного confirmation email не добавляйте маркетинговые блоки, которые меняют назначение сообщения и усложняют диагностику.
Событие провайдера выбирает действие
| Provider event | Действие системы | Сообщение пользователю |
|---|---|---|
| Rendering Failure/Reject | не повторять без исправления шаблона или запроса | предложить resend после устранения |
| DeliveryDelay | сохранить pending и дождаться следующего события | сообщить о задержке без обещания срока |
| Hard Bounce | не слать снова на тот же адрес автоматически | дать исправить адрес |
| Delivery | зафиксировать передачу серверу получателя | предложить проверить spam/filters и resend |
| Complaint | подавить будущую отправку по политике | не продолжать автоматические повторы |
AWS предупреждает, что события могут приходить более чем одним способом и обработка должна быть идемпотентной. Ключом дедупликации служит provider message ID вместе с типом или уникальным event ID. Webhook сначала сохраняется, затем меняет состояние: если обработчик упадёт, событие можно проиграть без второго письма.
Контрольный прогон заканчивается подтверждённым аккаунтом
- Зарегистрировать новый тестовый адрес и сохранить registration/event ID.
- Увидеть одну outbox-запись и одну обработанную задачу.
- Сопоставить её с provider message ID и финальным delivery-событием.
- Проверить заголовки SPF, DKIM и DMARC на полученном сообщении.
- Открыть ссылку один раз, затем повторно и убедиться в идемпотентном результате.
- Запросить resend и проверить выбранное поведение старой ссылки.
- Повторить сценарий bounce через официальный mailbox simulator провайдера, если он доступен.
Для разбора подготовьте UTC-время, маскированный адрес, registration ID, состояние outbox, provider message ID и обезличенный event payload. Этого достаточно, чтобы отличить ошибку приложения от почтовой доставки, не передавая пароль, токен или рабочую ссылку подтверждения.