Гайды

Как повторять неудачные запросы — 6 шагов, чтобы не удвоить платёж

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

Сеть моргнула, запрос не дошёл. Ты повторил — и клиенту списали деньги дважды.

Вот эта ловушка и есть главное в теме повторов. Не «как подождать», а «как повторить так, чтобы второй запрос не сделал вторую покупку». Разберём по шагам, код рабочий.

Что понадобится

Любой проект, который ходит в чужой API: платежи, отправка писем, запросы к модели. Примеры на JavaScript, но логика одинаковая везде.

1. Раздели ошибки на два ведра

Половина проблем с повторами — от того, что повторяют всё подряд.

const RETRYABLE = new Set([408, 425, 429, 500, 502, 503, 504]);

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

Во второе ведро — то, что временем не лечится: 400 (кривые данные), 401 и 403 (ключ или права), 404 (нет объекта), 422 (не прошло проверку). Их повторять нельзя: ответ не изменится, а ты сожжёшь лимит и попадёшь в бан.

2. Поставь таймаут — иначе повтора не будет

Неочевидный шаг, который пропускают чаще всего. Если сервер принял соединение и замолчал, твой запрос будет висеть — и до кода повтора дело просто не дойдёт.

const res = await fetch(url, {
  ...options,
  signal: AbortSignal.timeout(10_000), // 10 секунд и хватит
});

Правило: сначала таймаут, потом повторы. Без таймаута вся конструкция ниже мертва.

3. Считай паузу с джиттером

Каждая следующая пауза вдвое длиннее — и обязательно со случайной добавкой, иначе все клиенты вернутся в одну секунду и добьют сервис (подробно — в экспоненциальном бэкоффе).

const base = 500;      // мс
const cap  = 20_000;   // потолок паузы

function delay(attempt) {
  return Math.random() * Math.min(cap, base * 2 ** attempt);
}

Потолок нужен, чтобы шестая попытка не уехала на пять минут.

4. Слушайся Retry-After, если он пришёл

Сервер иногда сам говорит, сколько ждать — заголовком Retry-After при 429 и 503. Внутри число секунд или дата. Твоя формула тут проигрывает: сервер знает лучше.

const header = res.headers.get('Retry-After');
const wait = header ? Number(header) * 1000 : delay(attempt);

5. Сделай повтор безопасным

Тот самый двойной платёж. Проблема в том, что ответ мог потеряться уже после того, как сервер всё выполнил. Твой повтор для него — новый запрос.

Лечится ключом идемпотентности: ты сам придумываешь уникальную строку на операцию и шлёшь её заголовком. Сервер запоминает результат первого запроса с этим ключом и на повтор возвращает тот же ответ, ничего не выполняя заново.

const key = crypto.randomUUID(); // один ключ на всю операцию, не на попытку!
await fetch('https://api.stripe.com/v1/charges', {
  method: 'POST',
  headers: { 'Idempotency-Key': key },
  // ...
});

Ключ генерируется до первой попытки и не меняется между ними — иначе смысла нет. В Stripe это работает именно так: сохраняется код и тело первого ответа, ключи живут не меньше 24 часов, а если параметры повтора не совпали с исходными — придёт ошибка, чтобы ты случайно не оплатил другую сумму под тем же ключом. Ключи нужны только POST-запросам: GET и DELETE идемпотентны сами по себе.

6. Собери всё вместе

async function retryingFetch(url, options = {}, maxAttempts = 5) {
  for (let attempt = 0; ; attempt++) {
    const res = await fetch(url, {
      ...options,
      signal: AbortSignal.timeout(10_000),
    });

    const last = attempt === maxAttempts - 1;
    if (res.ok || !RETRYABLE.has(res.status) || last) return res;

    const header = res.headers.get('Retry-After');
    const wait = header ? Number(header) * 1000 : delay(attempt);
    console.warn(`retry ${attempt + 1}: ${res.status}, ждём ${Math.round(wait)} мс`);
    await new Promise((r) => setTimeout(r, wait));
  }
}

Обрати внимание на console.warn: без лога повторы становятся невидимыми. Сервис деградирует неделю, а ты узнаёшь об этом из счёта.

Что получится

Запрос, который переживает моргнувшую сеть и пятиминутную перегрузку чужого API, не долбит сервер в мёртвую и не списывает деньги дважды. На глаз — просто «стало надёжнее»: пропали случайные ошибки, которые ты не мог воспроизвести.

Как проверить, что это вообще работает

Код повторов коварен тем, что в обычный день он не выполняется ни разу. Проверять надо специально — и это две минуты.

Есть публичные заглушки, которые возвращают нужный код по запросу. Натрави свою функцию на такую:

// вернёт 503 — должен уйти в повторы и сдаться после maxAttempts
await retryingFetch('https://httpbin.org/status/503');

// вернёт 404 — должен вернуться сразу, без единой паузы
await retryingFetch('https://httpbin.org/status/404');

Что смотреть в логах: у первого — растущие паузы и разные числа на каждый запуск (если числа одинаковые, ты забыл Math.random). У второго — ни одной строчки retry. Если 404 ушёл в повторы, у тебя перепутаны вёдра из шага 1.

Третья проверка — на таймаут: дёрни адрес, который отвечает медленнее твоих 10 секунд (https://httpbin.org/delay/20), и убедись, что запрос обрывается, а не висит.

Сколько попыток ставить?

Фоновой задаче — 3–5. Запросу, где ждёт человек, — 1–2 и честная ошибка. И ограничивай не только число попыток, но и общее время: пользователь не должен ждать минуту ради пятой попытки.

А если повторы не помогают вообще?

Если сервис лежит десять минут, повторы только жгут твой лимит. Взрослое решение — сложить задачу в очередь и вернуться к ней позже, а пользователю сразу сказать «приняли, сделаем». Так работают все платёжные и почтовые интеграции.

Мой API не отдаёт Retry-After — что делать?

Использовать свою формулу из шага 3 и не считать это проблемой: Retry-After шлют далеко не все. Если сервис документирует лимиты — просто не подходи к ним вплотную, следи за счётчиком в заголовках ответа.

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

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

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

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

Все статьи →