Кнопка «Отмена» может честно вызвать `controller.abort()`, а через миллисекунду retry-механизм создаст новый `fetch`. Для пользователя это один и тот же запрос, но для программы — две попытки. Поэтому в Network важны инициатор и request id, а не только одинаковый URL.

Сначала ответьте на вопрос, дошла ли отмена до транспорта. Если первый запрос остаётся Pending, signal не передан или отменён другой controller. Если он завершается как canceled, а рядом появляется новый, ищите код, который владеет повтором: retry, refetch on focus, remount, effect или обработчик формы.

Временная шкала отличает продолжение от новой попытки

ПризнакЧто произошлоСледующая точка
Первый request всё ещё PendingAbortSignal не связанqueryFn/fetch options
Первый canceled, второй сразуRetry или повторный callbackattempt и stack initiator
Повтор после focusRefetch policyfocus/reconnect settings
Повтор после смены stateEffect/remountdependencies и component key
POST завершился на сервереКлиент отменил только ожиданиеoperation status/idempotency

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

Один controller управляет всей цепочкой fetch

const controller = new AbortController()

async function loadOrder(orderId) {
  const order = await fetch('/api/orders/' + orderId, {
    signal: controller.signal,
  }).then(assertOk).then((r) => r.json())

  const history = await fetch(order.historyUrl, {
    signal: controller.signal,
  }).then(assertOk).then((r) => r.json())

  return { order, history }
}

cancelButton.addEventListener('click', () => {
  controller.abort('user-cancelled')
})

AbortSignal можно передать нескольким связанным операциям. После abort этот signal остаётся aborted и не подходит для нового запуска; для осознанной новой операции создайте новый controller. Не переиспользуйте глобальный controller между независимыми экранами — отмена одного действия остановит соседнее.

Отмена не попадает в retry predicate

const query = useQuery({
  queryKey: ['order', orderId],
  queryFn: ({ signal }) =>
    fetch('/api/orders/' + orderId, { signal }).then(assertOk),
  retry: (failureCount, error) => {
    if (error?.name === 'AbortError') return false
    if (error?.status >= 400 && error?.status < 500) return false
    return failureCount < 2
  },
})

// Для кнопки отмены:
await queryClient.cancelQueries({ queryKey: ['order', orderId] })

TanStack Query передаёт queryFn сигнал и при ручном `cancelQueries` может отменить Promise, если signal действительно потреблён транспортом. В v5 отмена имеет собственную семантику состояния. Не оборачивайте queryFn в catch, который превращает AbortError в новый общий Error: так retry перестаёт различать намеренную отмену.

Новый запрос может прийти не из retry

  • Компонент размонтировался и смонтировался с новым key.
  • Окно вернулось в focus или сеть перешла online.
  • Effect зависит от объекта, создаваемого на каждом render.
  • Кнопка внутри form вызвала click и submit.
  • Два обработчика подписаны на одно действие.
  • Query key изменился, поэтому библиотека считает это другой query.

На время диагностики добавьте source label возле каждого места запуска: `effect`, `submit`, `focus`, `manual-refetch`. Не отключайте все автоматические refetch глобально до выяснения причины: они могут быть полезны другим экранам. Изменение должно соответствовать намерению пользователя именно в отменяемой операции.

Отмена записи не равна откату на сервере

Браузер может прекратить ожидание POST после того, как сервер уже принял и обработал его. Повтор такого запроса способен создать дубль. Для бизнес-операции клиент генерирует стабильный idempotency/operation key на одно действие, сервер сохраняет результат по этому ключу, а после отмены UI запрашивает статус вместо слепого повторения.

Метод/операцияБезопасность повтораКонтроль
GET чтениеОбычно идемпотентенОтменить и разрешить новый read
PUT полного ресурсаЗависит от условий/версииIf-Match или revision
POST оплаты/заказаНе предполагать безопасностьIdempotency key и status endpoint
Upload chunkТолько по протоколу с offsetsession id и подтверждённый offset
Background job startНужен operation idДедупликация на сервере

Тест проверяет отмену и возможный restart отдельно

  1. Задержать ответ первого запроса и нажать «Отмена».
  2. Убедиться, что transport получил abort и UI вышел из pending.
  3. Подождать дольше максимального retryDelay: нового attempt быть не должно.
  4. Перевести вкладку background/foreground и сеть offline/online.
  5. Нажать «Повторить» вручную: теперь допустим новый controller и attempt.
  6. Для POST проверить на сервере, что один operation key дал не более одного эффекта.

Исправление готово, когда явная отмена завершает всю связанную цепочку, не классифицируется как ошибка для retry, скрытые триггеры не создают новую попытку, а повтор записи не дублирует эффект. Для анализа нужны Network HAR без секретов, query/effect config и журнал operation_id/attempt/controller_id.

Проверенные источники