Если один serial уже оказался в двух оплаченных заказах, сначала запретите дальнейшие операции с ним и сохраните audit trail: order IDs, timestamps, payment states, warehouse movements и idempotency keys. Не удаляйте одну строку ради красивого отчёта. Нужно выяснить, какой покупатель получил подтверждение и какие внешние действия уже нельзя откатить простой транзакцией.
Классическая гонка выглядит безобидно: запрос A читает available, запрос B читает available, оба создают продажу, затем оба меняют статус. Проверка перед INSERT не является запретом. Между SELECT и записью другой процесс успевает изменить мир. Инвариант должен проверяться базой в момент записи.
Два запроса проходят одну и ту же проверку
| Момент | Касса A | Касса B |
|---|---|---|
| T1 | SELECT state = available | — |
| T2 | — | SELECT state = available |
| T3 | INSERT sale для SN-42 | — |
| T4 | — | INSERT sale для SN-42 |
| T5 | COMMIT | COMMIT |
В PostgreSQL unique constraint гарантирует уникальность значений столбца или их комбинации и автоматически создаёт unique B-tree index. Если запрещены только активные продажи, нужен partial unique index с точно сформулированным predicate. Но статусная модель должна исключать лазейку, когда одна операция преждевременно переводит старую строку в неактивную.
Первый вариант: атомарно забираем доступный экземпляр
BEGIN;
UPDATE inventory_unit
SET state = 'reserved', reserved_by = :order_id
WHERE serial_no = :serial_no
AND state = 'available'
RETURNING id;
-- продолжать только если возвращена ровно одна строка
INSERT INTO sale_unit(order_id, inventory_unit_id, serial_no)
VALUES (:order_id, :unit_id, :serial_no);
COMMIT;Concurrent UPDATE той же строки сериализуется через row-level lock, а условие state перепроверяется. Проигравший запрос получает ноль строк и должен ответить «товар уже зарезервирован», не создавать sale. Уникальный constraint на inventory_unit_id или serial_no остаётся вторым барьером и защищает другие code paths, миграции и ручные запросы.
Второй вариант: явно блокируем строку до решения
BEGIN;
SELECT id, state
FROM inventory_unit
WHERE serial_no = :serial_no
FOR UPDATE;
-- проверить state, создать sale и изменить inventory в этой транзакции
-- внешнюю оплату не держать под database lock
COMMIT;SELECT FOR UPDATE блокирует выбранную строку от конкурентных изменений до конца транзакции. Это подходит, если решение требует нескольких связанных записей, но транзакция должна быть короткой. Не вызывайте медленный платёжный API под row lock: сначала создайте устойчивую reservation с TTL, завершите транзакцию, затем ведите платёж отдельным workflow.
Повторы запроса не должны создавать вторую продажу
- Клиент присылает idempotency key, стабильный для одной попытки checkout.
- Таблица операций имеет UNIQUE по merchant и idempotency key.
- Повтор возвращает сохранённый order ID и результат, а не запускает резервирование заново.
- ON CONFLICT используется только с понятным arbiter constraint и проверкой payload.
- Одинаковый ключ с другим serial или суммой отклоняется как конфликт.
- Истечение reservation обрабатывает отдельный worker с теми же транзакционными гарантиями.
Уровень Serializable может обнаружить опасную комбинацию чтений и откатить одну транзакцию с serialization failure. Тогда приложение обязано повторить всю транзакцию по политике, сохранив idempotency key. Более высокий isolation не заменяет уникальный инвариант и понятный пользовательский ответ проигравшей операции.
Старые дубли исправляются отдельно от нового ограничения
- Найти serial с COUNT активных продаж больше одного и остановить автоматическую отгрузку.
- Сверить платежи, чеки, фактическое движение товара и время подтверждения.
- Выбрать бизнес-решение для каждой конфликтующей операции и уведомить ответственных.
- Только после очистки создать constraint или partial unique index.
- Запустить два параллельных checkout в тесте и проверить: один success, один conflict.
- Добавить метрику unique violation и нулевого результата conditional update.
Что считать доказанным исправлением
Проверьте все пути: касса, API, импорт, возврат, перенос между складами и административную форму. На одинаковом serial запустите десятки параллельных запросов и повторите каждый с тем же idempotency key. В результате должна существовать одна активная продажа, один владелец reservation и объяснимые ответы остальным запросам; ни один rollback не должен оставлять inventory в проданном состоянии без связанной операции.