Что такое идемпотентность — и почему с карты списали дважды

Вот неприятная штука, которую редко объясняют новичкам: двойное списание с карты чаще всего происходит не потому, что пользователь дважды нажал кнопку.
Он нажал один раз. Запрос дошёл до сервера. Сервер списал деньги и начал отвечать «готово» — и в этот момент у пользователя мигнул интернет. Ответ не доехал. Его телефон решил, что запрос потерялся, и вежливо отправил его ещё раз. Сервер получил второй, точно такой же запрос и снова списал деньги, потому что для него это новая просьба.
Свойство, которое защищает от этой ситуации, называется идемпотентностью. Звучит как что-то из учебника — а на деле это самая практичная идея во всём, что касается денег и данных.
Определение в одну строку
Идемпотентная операция — та, повтор которой ничего не меняет.
Сравни две просьбы:
- «Поставь громкость на 5» — можно повторить сто раз, громкость останется 5. Идемпотентно.
- «Сделай громче на единицу» — сто повторов, и ты оглох. Не идемпотентно.
С данными то же самое. «Пользователь с id 7 теперь называется Аня» — сколько ни повторяй, результат один. «Создай нового пользователя Аня» — повторил трижды, получил трёх Ань.
Откуда берётся повтор, которого никто не делал
Ключевая мысль: повтор запроса — это норма, а не сбой. Он случается сам, без участия человека, минимум по трём причинам.
- Потерянный ответ. Запрос дошёл, работа выполнена, а ответ не вернулся — оборвалась связь или сработал таймаут. Клиент не может отличить «не дошло» от «дошло, но ответ потерялся», и по умолчанию пробует снова.
- Автоматические повторы. Мобильные библиотеки, серверные HTTP-клиенты, очереди задач — почти все повторяют запрос при сетевой ошибке. Часто ты об этом даже не знаешь.
- Вебхуки. Платёжные и почтовые сервисы гарантируют доставку «хотя бы один раз»: если твой сервер ответил медленно или отдал ошибку, тот же самый вебхук придёт ещё раз. И ещё. Это штатное поведение, а не поломка.
Вывод неуютный, но полезный: если твой обработчик оплаты не готов увидеть один и тот же запрос дважды — однажды он его увидит.
Какие запросы безопасны сами по себе
В HTTP это заложено в смысл методов — и как раз здесь новички чаще всего промахиваются:
GET— читает. Повторяй сколько хочешь.PUT— «пусть станет вот так». Повтор приводит к тому же состоянию. Идемпотентно.DELETE— «пусть этого не будет». Второй раз удалять уже нечего, состояние то же. Идемпотентно.POST— «создай ещё одно». Не идемпотентно — и именно на нём висят оплаты, заказы и регистрации.
Полезная привычка: писать «поставь такое значение» вместо «прибавь единицу». PUT /cart/items/42 {quantity: 3} безопасен, а POST /cart/add при повторе положит в корзину лишний товар. Подробнее про то, что означают коды ответа, — в отдельном разборе.
Как сделать POST идемпотентным
Прячется вся идея в одном приёме: пусть клиент сам назовёт операцию, а сервер запомнит имя.
- Клиент, формируя платёж, генерирует случайный идентификатор — обычный UUID — и кладёт его в заголовок. У платёжных API это стандарт: у Stripe заголовок называется
Idempotency-Key. - Сервер, получив запрос, сначала смотрит: операция с таким ключом уже выполнялась?
- Если нет — выполняет и сохраняет результат рядом с ключом.
- Если да — не выполняет заново, а возвращает сохранённый ответ. Клиент видит «готово» и успокаивается.
Важная деталь: ключ генерируется один раз на попытку оплаты, а не на каждый сетевой запрос. Иначе повтор принесёт новый ключ и весь смысл пропадёт.
И страховка на уровне базы: уникальный индекс. Если у заказа есть поле payment_id, пометь его UNIQUE — тогда вторая вставка просто не пройдёт, даже если логика где-то дала слабину. Это тот же приём, что защищает от гонки двух одновременных запросов.
Что с этим делать прямо сейчас
Открой у себя обработчик, который создаёт что-то важное — оплату, заказ, начисление — и задай ему один вопрос: что произойдёт, если этот же запрос придёт второй раз через секунду? Если ответ «создастся дубль» — там дырка, и её видно ещё до того, как придут пользователи. Как подключить оплату так, чтобы этот вопрос был задан вовремя, — разбираем в гайде про платежи.
Идемпотентность — это то же, что «ровно один раз»?
Нет. «Ровно один раз» по сети практически недостижимо: доставка гарантируется «хотя бы один раз». Идемпотентность — способ жить с этим: пусть запрос придёт трижды, а эффект будет как от одного.
Сколько хранить ключи идемпотентности?
Достаточно суток — повторы случаются в пределах секунд или минут. Stripe, например, держит ключи 24 часа; для своего проекта это хороший ориентир.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





