Начните с одного пользователя и одного времени регистрации. В базе найдите событие `user_registered`, задачу очереди и provider message ID. Если ID провайдера нет, письмо потерялось внутри приложения. Если он есть, смотрите `delivery`, `bounce`, `reject` или `delivery delay`, а не строку «отправлено» в вашем интерфейсе.

Повторную отправку делайте только после фиксации этой цепочки. Иначе несколько воркеров выпустят несколько писем и ссылок, пользователь откроет старую, а журнал превратится в набор несвязанных попыток. Безопасный resend создаёт новую попытку, инвалидирует или логически заменяет предыдущий токен и сохраняет связь с тем же аккаунтом.

Почтовая цепочка имеет пять разных состояний

СостояниеГде подтверждаетсяЧто означает
event createdтаблица outbox/доменное событиерегистрация решила отправить письмо
job processedжурнал worker и attemptшаблон собран, вызов провайдера выполнен
acceptedprovider message IDпровайдер принял запрос, но inbox ещё не подтверждён
delivery/bounce/delaywebhook или 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 сначала сохраняется, затем меняет состояние: если обработчик упадёт, событие можно проиграть без второго письма.

Контрольный прогон заканчивается подтверждённым аккаунтом

  1. Зарегистрировать новый тестовый адрес и сохранить registration/event ID.
  2. Увидеть одну outbox-запись и одну обработанную задачу.
  3. Сопоставить её с provider message ID и финальным delivery-событием.
  4. Проверить заголовки SPF, DKIM и DMARC на полученном сообщении.
  5. Открыть ссылку один раз, затем повторно и убедиться в идемпотентном результате.
  6. Запросить resend и проверить выбранное поведение старой ссылки.
  7. Повторить сценарий bounce через официальный mailbox simulator провайдера, если он доступен.

Для разбора подготовьте UTC-время, маскированный адрес, registration ID, состояние outbox, provider message ID и обезличенный event payload. Этого достаточно, чтобы отличить ошибку приложения от почтовой доставки, не передавая пароль, токен или рабочую ссылку подтверждения.

Проверенные источники