Кнопка «Отмена» может честно вызвать `controller.abort()`, а через миллисекунду retry-механизм создаст новый `fetch`. Для пользователя это один и тот же запрос, но для программы — две попытки. Поэтому в Network важны инициатор и request id, а не только одинаковый URL.
Сначала ответьте на вопрос, дошла ли отмена до транспорта. Если первый запрос остаётся Pending, signal не передан или отменён другой controller. Если он завершается как canceled, а рядом появляется новый, ищите код, который владеет повтором: retry, refetch on focus, remount, effect или обработчик формы.
Временная шкала отличает продолжение от новой попытки
| Признак | Что произошло | Следующая точка |
|---|---|---|
| Первый request всё ещё Pending | AbortSignal не связан | queryFn/fetch options |
| Первый canceled, второй сразу | Retry или повторный callback | attempt и stack initiator |
| Повтор после focus | Refetch policy | focus/reconnect settings |
| Повтор после смены state | Effect/remount | dependencies и 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 | Только по протоколу с offset | session id и подтверждённый offset |
| Background job start | Нужен operation id | Дедупликация на сервере |
Тест проверяет отмену и возможный restart отдельно
- Задержать ответ первого запроса и нажать «Отмена».
- Убедиться, что transport получил abort и UI вышел из pending.
- Подождать дольше максимального retryDelay: нового attempt быть не должно.
- Перевести вкладку background/foreground и сеть offline/online.
- Нажать «Повторить» вручную: теперь допустим новый controller и attempt.
- Для POST проверить на сервере, что один operation key дал не более одного эффекта.
Исправление готово, когда явная отмена завершает всю связанную цепочку, не классифицируется как ошибка для retry, скрытые триггеры не создают новую попытку, а повтор записи не дублирует эффект. Для анализа нужны Network HAR без секретов, query/effect config и журнал operation_id/attempt/controller_id.