Клиент отправил POST для создания заказа, не дождался ответа из-за таймаута и повторил запрос. Как правильно не допустить второго заказа?

POST не идемпотентен, а клиент после таймаута не знает, создан ли заказ. Повторить нельзя — будет два заказа; не повторить — заказ может потеряться. Решение — сделать операцию идемпотентной явно.

Схема:

1. клиент генерирует UUID для конкретного намерения («оформить эту корзину») и отправляет Idempotency-Key: <uuid>. При повторе — тот же ключ;
2. сервер в одной транзакции: вставляет ключ в таблицу (уникальный индекс), создаёт заказ, сохраняет ответ рядом с ключом;
3. если ключ уже есть — возвращает сохранённый ответ, не создавая заказ;
4. если запрос с этим ключом ещё выполняется (параллельный повтор) — ждать или ответить 409 «в обработке».

Критичные детали:

• ключ и бизнес-изменение — в одной транзакции, иначе можно упасть между ними и получить заказ без ключа (или ключ без заказа);
• проверять, что тело совпадает с исходным: тот же ключ с другими данными — ошибка клиента;
• не сравнивать тела вместо ключа: два разных заказа могут совпасть по содержимому;
• срок хранения ключей — сутки или неделя, потом чистить.

Так работают API Stripe, ЮKassa и других платёжных систем. Для сообщений из брокера с доставкой «хотя бы один раз» — та же идея: id сообщения в таблице обработанных в одной транзакции с эффектом.

BEGIN;
INSERT INTO idempotency_keys(key, request_hash) VALUES ($1, $2);   -- уникальный индекс
INSERT INTO orders(...) VALUES (...) RETURNING id;
UPDATE idempotency_keys SET response = $3 WHERE key = $1;
COMMIT;
-- повтор: INSERT упадёт по уникальности → SELECT response FROM idempotency_keys WHERE key = $1