Как повторять неудачные запросы — 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 коротких урока на телефоне.





