Что такое…

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

Иллюстрация: кнопку нажали один раз, а из автомата выехало два одинаковых чека

Вот неприятная штука, которую редко объясняют новичкам: двойное списание с карты чаще всего происходит не потому, что пользователь дважды нажал кнопку.

Он нажал один раз. Запрос дошёл до сервера. Сервер списал деньги и начал отвечать «готово» — и в этот момент у пользователя мигнул интернет. Ответ не доехал. Его телефон решил, что запрос потерялся, и вежливо отправил его ещё раз. Сервер получил второй, точно такой же запрос и снова списал деньги, потому что для него это новая просьба.

Свойство, которое защищает от этой ситуации, называется идемпотентностью. Звучит как что-то из учебника — а на деле это самая практичная идея во всём, что касается денег и данных.

Определение в одну строку

Идемпотентная операция — та, повтор которой ничего не меняет.

Сравни две просьбы:

  • «Поставь громкость на 5» — можно повторить сто раз, громкость останется 5. Идемпотентно.
  • «Сделай громче на единицу» — сто повторов, и ты оглох. Не идемпотентно.

С данными то же самое. «Пользователь с id 7 теперь называется Аня» — сколько ни повторяй, результат один. «Создай нового пользователя Аня» — повторил трижды, получил трёх Ань.

Откуда берётся повтор, которого никто не делал

Ключевая мысль: повтор запроса — это норма, а не сбой. Он случается сам, без участия человека, минимум по трём причинам.

  • Потерянный ответ. Запрос дошёл, работа выполнена, а ответ не вернулся — оборвалась связь или сработал таймаут. Клиент не может отличить «не дошло» от «дошло, но ответ потерялся», и по умолчанию пробует снова.
  • Автоматические повторы. Мобильные библиотеки, серверные HTTP-клиенты, очереди задач — почти все повторяют запрос при сетевой ошибке. Часто ты об этом даже не знаешь.
  • Вебхуки. Платёжные и почтовые сервисы гарантируют доставку «хотя бы один раз»: если твой сервер ответил медленно или отдал ошибку, тот же самый вебхук придёт ещё раз. И ещё. Это штатное поведение, а не поломка.

Вывод неуютный, но полезный: если твой обработчик оплаты не готов увидеть один и тот же запрос дважды — однажды он его увидит.

Какие запросы безопасны сами по себе

В HTTP это заложено в смысл методов — и как раз здесь новички чаще всего промахиваются:

  • GET — читает. Повторяй сколько хочешь.
  • PUT — «пусть станет вот так». Повтор приводит к тому же состоянию. Идемпотентно.
  • DELETE — «пусть этого не будет». Второй раз удалять уже нечего, состояние то же. Идемпотентно.
  • POST — «создай ещё одно». Не идемпотентно — и именно на нём висят оплаты, заказы и регистрации.

Полезная привычка: писать «поставь такое значение» вместо «прибавь единицу». PUT /cart/items/42 {quantity: 3} безопасен, а POST /cart/add при повторе положит в корзину лишний товар. Подробнее про то, что означают коды ответа, — в отдельном разборе.

Как сделать POST идемпотентным

Прячется вся идея в одном приёме: пусть клиент сам назовёт операцию, а сервер запомнит имя.

  1. Клиент, формируя платёж, генерирует случайный идентификатор — обычный UUID — и кладёт его в заголовок. У платёжных API это стандарт: у Stripe заголовок называется Idempotency-Key.
  2. Сервер, получив запрос, сначала смотрит: операция с таким ключом уже выполнялась?
  3. Если нет — выполняет и сохраняет результат рядом с ключом.
  4. Если да — не выполняет заново, а возвращает сохранённый ответ. Клиент видит «готово» и успокаивается.

Важная деталь: ключ генерируется один раз на попытку оплаты, а не на каждый сетевой запрос. Иначе повтор принесёт новый ключ и весь смысл пропадёт.

И страховка на уровне базы: уникальный индекс. Если у заказа есть поле payment_id, пометь его UNIQUE — тогда вторая вставка просто не пройдёт, даже если логика где-то дала слабину. Это тот же приём, что защищает от гонки двух одновременных запросов.

Что с этим делать прямо сейчас

Открой у себя обработчик, который создаёт что-то важное — оплату, заказ, начисление — и задай ему один вопрос: что произойдёт, если этот же запрос придёт второй раз через секунду? Если ответ «создастся дубль» — там дырка, и её видно ещё до того, как придут пользователи. Как подключить оплату так, чтобы этот вопрос был задан вовремя, — разбираем в гайде про платежи.

Идемпотентность — это то же, что «ровно один раз»?

Нет. «Ровно один раз» по сети практически недостижимо: доставка гарантируется «хотя бы один раз». Идемпотентность — способ жить с этим: пусть запрос придёт трижды, а эффект будет как от одного.

Сколько хранить ключи идемпотентности?

Достаточно суток — повторы случаются в пределах секунд или минут. Stripe, например, держит ключи 24 часа; для своего проекта это хороший ориентир.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →