Если две одинаковые заявки появляются с разницей в миллисекунды, проблема почти никогда не в «невнимательном клиенте». Двойной клик лишь показывает, что сервер не умеет распознавать повтор одной операции.
Надёжное исправление состоит из двух частей: клиент передаёт стабильный 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 и схему ограничений таблицы.