Почему нельзя полагаться только на уникальный индекс для реализации идемпотентности?

Многие разработчики считают, что достаточно создать уникальный индекс:

CREATE UNIQUE INDEX idx_order_id ON orders(order_id);

и проблема идемпотентности решена.

На практике это не так.

Представим сценарий:

1. Приходит запрос на создание заказа.

2. Заказ успешно создаётся.

3. После этого отправляется событие в Kafka.

4. Сервис падает.

5. Клиент делает повторный запрос.

Уникальный индекс защитит таблицу от дубля заказа, но:

• событие может быть отправлено повторно;

• письмо пользователю может уйти второй раз;

• деньги могут списаться повторно.

Поэтому идемпотентность обычно строится через:

• idempotency key;

• таблицу обработанных операций;

• outbox pattern;

• атомарную запись результата операции.

Пример:

CREATE TABLE idempotency_keys (
		key TEXT PRIMARY KEY,
		response JSONB
);

При повторном запросе возвращается сохранённый результат.

Вывод:

Уникальный индекс - это лишь один из инструментов идемпотентности, но не полноценное решение.