Если две одинаковые заявки появляются с разницей в миллисекунды, проблема почти никогда не в «невнимательном клиенте». Двойной клик лишь показывает, что сервер не умеет распознавать повтор одной операции.

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

Откуда берётся второй экземпляр

  • Кнопка отправляет форму и одновременно запускает JavaScript handler.
  • Клиент не получает ответ вовремя и повторяет POST.
  • Consumer падает после INSERT, но до подтверждения сообщения.
  • Два сотрудника открывают заказ и создают возврат параллельно.

Добавьте correlation_id на входе и выведите в один журнал HTTP request, команду, INSERT и опубликованное событие. У настоящего повтора обычно один смысловой ключ при разных request_id. У двух самостоятельных действий будут разные основания или состав позиций.

Ключ должен описывать действие, а не соединение

Случайный UUID, который генерируется заново при каждом retry, бесполезен. Ключ создаётся один раз при начале операции и повторно отправляется до получения окончательного ответа. На сервере с ним связывают параметры запроса и сохранённый результат.

POST /orders/8472/returns
Idempotency-Key: return-8472-client-6f91...

{"items":[{"order_item_id":51,"quantity":1}],"reason":"damaged"}

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

Почему нужен барьер в базе

Два процесса могут одновременно проверить «возврата ещё нет» и оба выполнить INSERT. Поэтому проверка в коде не заменяет уникальное ограничение или блокировку бизнес-объекта. Конкретный ключ зависит от правил магазина: например, одна активная заявка на order_item и количество либо один client_operation_id.

ЗащитаЧто ловитЧего не ловит
Disabled buttonПовторный клик в одном окнеСеть, другой клиент, очередь
Idempotency keyПовтор одной командыДве разные команды на тот же товар
Unique constraintГонку при записиОшибочно выбранное бизнес-правило

Проверьте не только число строк

Параллельно отправьте 10 одинаковых запросов. В базе должна появиться одна заявка, все ответы должны ссылаться на неё, а событие `return.created` — публиковаться один раз. Затем повторите ключ с изменённым телом и убедитесь, что сервер не создаёт новую запись.

Отдельный тест нужен на падение после commit: consumer получает сообщение повторно и должен обнаружить уже созданный результат. Именно этот сценарий чаще всего проходит незаметно в обычном ручном тестировании.

Как убрать существующие дубли

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

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