Янтарный стеклянный шар в металлической подставке с синей ручкой.

Сервер создал заявку, но браузер не дождался ответа и повторил отправку. Отключённая кнопка не поможет, если запрос повторил другой процесс или клиент перезапустился. Я разбираю защиту через идентичность одной операции: её попытки должны вести к согласованному результату, а новая потребность того же человека — оставаться новой.

Ниже есть последовательный и конкурентный повтор, неизвестный итог внешнего API и проверка после перезапуска. Механизмы поставщиков различаются: у Stripe поведение зависит в том числе от версии API, у ЮKassa свой контракт. Сроки и ключи из одного сервиса нельзя переносить в другую интеграцию как универсальное правило.

Пример неизвестного результата

Первый запрос создал обращение, но соединение разорвалось до получения ответа. Клиент повторяет прежний запрос с тем же ключом. Ожидается получение состояния исходной операции, а не второй записи. Для проверки нужно намеренно смоделировать потерю ответа в тестовом окружении и сверить хранилище. Затем выполните новую самостоятельную отправку с другим ключом и теми же контактами. Она должна обрабатываться как отдельная потребность, если таков контракт. Это отличает идемпотентность от грубой блокировки всех похожих обращений, которая способна терять реальные повторные покупки.

Отдельно решите, как показывать уже выполняющуюся операцию. Немедленный повтор может прийти до готовности результата, и система не должна выдумывать успешное завершение. Допустим понятный статус обработки с предусмотренным способом последующей проверки. Важна согласованность клиента и сервера: интерфейс не должен создавать новый ключ только потому, что предыдущий ответ пока не содержит конечной записи.

Набор проверок

  • Два последовательных запроса с одним ключом создают одну запись.
  • Два одновременных запроса дают тот же бизнес-результат.
  • Новый ключ позволяет создать самостоятельное обращение.
  • Изменённые параметры старого ключа не принимаются незаметно.
  • Перезапуск обработчика не забывает незавершённую операцию.

Проверьте также срок хранения состояния и безопасный способ ручного восстановления. Слишком раннее удаление ключей возвращает риск дублей при позднем повторе. В отчёте полезно указывать число созданных бизнес-объектов и состояние каждого запроса. Правильная идемпотентность подтверждается именно этим, а не отсутствием второй анимации на кнопке отправки.

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

Рабочий сценарий

Идемпотентность: сохранить смысл одной операции

Технические повторы не должны создавать новые потребности или скрывать самостоятельные

01

Граница

Определить новую потребность и технический повтор

02

Ключ

Создать идентичность до первой попытки и сохранить для продолжений

03

Состояние

Связать ключ, параметры и известный результат

04

Атомарность

Защитить приём от конкурентных запросов

05

Внешний эффект

Проверить API-контракт и неизвестные результаты

06

Испытание

Повторить последовательность, одновременность и перезапуск

Предыдущая внешняя запись могла завершиться без полученного ответа?

Условие выполнено: Сначала сверить фактическое состояние и не создавать объект вслепую

Условие не выполнено: Продолжить по принятому контракту и сохранённому ключу

Ответственный
Разработчик обработчика и владелец операции

Подтверждение
Число бизнес-объектов и состояния запросов при контролируемых повторах

Что измеряем
Количество неожиданных дублей и потерянных самостоятельных обращений

Скачать схему процесса в SVG · Скачать рабочую таблицу CSV

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

На входе нужен тип операции, состав значимых параметров и возможные внешние эффекты. Владелец процесса определяет, что считается новым обращением. Разработчик клиента создаёт и сохраняет идентичность отправки. Разработчик сервера обеспечивает устойчивый учёт. Сопровождающий получает процедуру неизвестных результатов. У платёжного или CRM-получателя могут быть собственные правила, которые также входят в контракт.

Первый этап — решить, когда возникает ключ. Он должен существовать до первой потенциально повторяемой попытки и сохраняться для её продолжений. Новый случай получает новый ключ. Не следует создавать его заново после каждого таймаута: тогда повтор не отличим от самостоятельного действия. Также не нужно использовать личные сведения как удобный идентификатор, если техническая случайная строка решает задачу без их распространения.

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

СостояниеЧто известно системеБезопасное направлениеНежелательная подмена
Новый ключТакой операции ещё не учтеноАтомарно принять и начать обработкуНесвязанные параллельные записи
ВыполняетсяРезультат ещё не окончательныйВернуть понятный статус или предусмотренное ожиданиеВыдуманный успех
ЗавершеноИзвестен сохранённый итогПовторно сообщить результат по контрактуНовое бизнес-действие
Неизвестный внешний итогЗапрос мог быть принят другой системойСверить фактический объектСлепая повторная запись
Другие параметры того же ключаИдентичность и содержимое расходятсяПрименить согласованную проверку конфликтаНезаметное изменение прежней операции

Опишите, на каком шаге появляются дубли: форма, обработчик или внешняя CRM. Помогу определить единицу операции и контрольный сценарий с потерей ответа. Написать в Telegram · Написать в MAX.

Третий этап — обеспечить атомарность приёма. Последовательность «проверили отсутствие, затем вставили» может пропустить два одновременных запроса. Подходящая транзакция, ограничение или другой механизм выбирается по хранилищу. Нельзя объявлять защиту доказанной по одному последовательному тесту. Конкурентный сценарий относится к самой причине риска и должен быть частью проверки.

Выход процесса — одна учтённая операция с воспроизводимым состоянием и определённой судьбой повторов. Это не означает, что любой внешний сервис автоматически поддерживает такой же контракт. Поведение API, срок действия ключей и ответы при ошибках сверяют по официальной документации конкретного поставщика и версии. Механизм Stripe не следует считать универсальным описанием ЮKassa или CRM.

Диагностический пример: ответ потерян после сохранения

Сервер создал заявку, но клиент не получил успешный ответ из-за сетевого разрыва. Затем браузер повторил отправку. Это обычная неопределённость распределённого процесса: клиент знает только о соединении, а не об отсутствии записи. Если повтор получает новый ключ, система может корректно с точки зрения кода создать вторую заявку, нарушив смысл пользовательского действия.

На тестовом окружении моделируют потерю ответа после сохранения. Затем отправляют тот же запрос с прежней идентичностью. Ожидают предусмотренный результат исходной операции и проверяют число записей. Не нужно создавать реальную аварию рабочей сети или многократно отправлять заявки клиентов. Достаточен ограниченный опыт с явно тестовыми данными и понятным завершением.

После этого выполняют новое самостоятельное обращение с тем же контактом и другим предметом. Оно должно пройти как отдельная потребность, если таково правило бизнеса. Таким образом проверяются обе стороны: отсутствие технического дубля и отсутствие потери нового запроса. Грубая дедупликация по одному полю не закрывает обе задачи автоматически.

В отчёте полезны исходная операция, её попытки и конечный объект. Не нужно копировать личные данные в каждый технический журнал. Связь по безопасному номеру даёт достаточно информации для разбора. Если система хранит только итог без попыток, может быть трудно понять причину задержки, но бесконтрольная запись всего payload тоже не является необходимым решением.

Диагностический пример: два запроса прошли проверку отсутствия

Оба обработчика одновременно прочитали, что ключа ещё нет. Затем каждый отдельно создал запись. В обычной ручной проверке всё выглядело исправным, потому что второй запрос шёл после завершения первого. Это типичная разница между последовательной логикой интерфейса и реальным конкурентным сохранением.

Разработчик проверяет механизм хранилища и границу транзакции. Уникальность должна обеспечиваться там, где принимается решение, а не только в памяти одного процесса. Если приложение запущено несколькими работниками, локальный флаг одного экземпляра не защищает остальные. Конкретная техника зависит от базы и архитектуры; универсальный псевдокод не заменяет её корректную реализацию.

Для приёмки используют две синхронизированные попытки на разрешённом окружении. Проверяют фактическое число объектов и ответы обеим сторонам. Ошибка второго запроса может быть допустима по контракту, но она должна быть понятной, а первая операция — действительно сохранённой. Если обе стороны видят успех, а в базе два объекта, защита не работает независимо от красивого текста интерфейса.

Затем проверяют остановку и перезапуск. Состояние не должно забываться так, чтобы поздний повтор снова считался новым. Если ключи очищаются по сроку, этот срок должен соответствовать возможным повторам и правилам внешней системы. Бессрочное хранение тоже не принимают автоматически: необходима обоснованная политика для конкретной операции и данных.

Внешний эффект и локальная транзакция

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

Если принимающий API предоставляет поддерживаемый механизм идемпотентности, его используют по официальным правилам. Если нет, нужен другой согласованный способ установить фактическое состояние или ограничить повтор. Поиск по похожим контактам не всегда однозначен: у человека могут быть разные обращения. Нельзя подменять техническую идентичность случайным совпадением бизнес-полей.

Порядок работы описывают состояниями: принятие, внешняя попытка, подтверждённый результат, неизвестный итог и разрешённое продолжение. В неизвестном состоянии система не должна уверенно говорить, что операция не выполнена. Сопровождающий получает безопасный путь сверки, а пользователь — понятное объяснение без раскрытия внутренних секретов и подробностей доступа.

Сроки и ручное восстановление

У правил хранения ключа есть практическая цена. Слишком раннее удаление позволяет позднему повтору создать новый объект. Слишком долгое сохранение лишних данных увеличивает объём и усложняет сопровождение. Поэтому ключ связывают с минимальными необходимыми сведениями, а сроки выбирают по контракту и процессу, не перенося произвольные числа одного API на другую интеграцию.

Для ручного восстановления нужен ограниченный инструмент или процедура, которая не сбрасывает историю наугад. Удаление записи о ключе ради повторного запуска может повторить уже совершённый внешний эффект. Сначала устанавливают состояние источника и допустимость продолжения. Если нужно компенсирующее действие, это отдельное бизнес-решение с собственными полномочиями, а не техническая очистка кэша.

Сценарии приёмки

Первый сценарий — два последовательных одинаковых запроса. Получается один бизнес-объект и предусмотренный повторный ответ. Второй — два конкурентных запроса с тем же ключом. Проверка направлена именно на атомарность, поэтому простое быстрое двойное нажатие без контроля одновременности может быть недостаточным доказательством.

Третий сценарий — изменённые параметры прежнего ключа. Система не скрывает конфликт и не выдаёт чужой по смыслу результат. Четвёртый — новая потребность с прежними контактами и новым ключом. Она обрабатывается по обычному правилу, не исчезая внутри технической защиты.

Пятый сценарий — потеря ответа и перезапуск. Учтённая операция сохраняется, а повтор не выполняет внешний эффект второй раз. Шестой — неизвестный итог внешнего API. Процедура сверки позволяет получить достоверное состояние, не создавая новую запись в надежде, что первой не было. Для всех опытов используют разрешённые данные и не затрагивают настоящие платежи без отдельного основания.

Передача результата

Владелец получает понятное определение операции, повторов и нового запроса. Разработчику сопровождения нужны состояния, срок ключа, поведение конфликтов и путь восстановления. Секреты и личные данные не должны быть частью публичного описания. Минимальный технический номер связывает события без лишнего раскрытия.

Показатель качества — число бизнес-объектов и корректность состояний при проверенных повторах. Отсутствие второй анимации на кнопке ничего не доказывает о сервере. Предметная приёмка показывает, что система сохраняет смысл действия клиента даже при сетевой неопределённости, а не просто скрывает неудобное повторное нажатие в интерфейсе.

Официальные материалы

Вопросы по теме

Достаточно уникального индекса в своей базе?

Он может защитить локальную запись, но внешний API способен выполнить действие до потери ответа. Нужно отдельно описать внешний эффект, неизвестный итог и предусмотренную сверку.

При таймауте нужно выпустить новый ключ?

Для технического повтора той же операции это обычно разрушает её идентичность. Продолжение определяется контрактом конкретного API; сначала нужно установить, что известно о прежней попытке.

Обсудить ваш случай

Создание сайтов и веб-сервисов · Написать мне