Асинхронные ошибки в useEffect
На этой странице
Ошибка, возникшая после await внутри эффекта, не ловится Error Boundary: эффект уже завершился, а исключение превращается в отклонённый промис. Если его не обработать, будет Unhandled promise rejection, а экран может навсегда остаться в загрузке. Поэтому асинхронный код в эффекте обязан сам: ловить ошибки (try/catch или .catch), проверять response.ok (fetch не бросает на 404/500), отличать отмену от сбоя (AbortError — не ошибка для пользователя), не обновлять состояние устаревшего запроса — включая setError и setLoading(false) в finally. Если ошибку всё же нужно показать через ближайший Error Boundary, её перебрасывают в рендер: сохраняют в state и бросают при следующем рендере (или используют showBoundary из react-error-boundary).
Вопрос
Как правильно обрабатывать ошибки асинхронных операций в useEffect? Почему Error Boundary их не ловит?
Почему Error Boundary не видит ошибку
Render ──▶ Commit ──▶ useEffect(() => { load(); }) ← эффект завершился сразу
│
└─ load(): await fetch(...) ⋯ 500 мс ⋯ throw Error
│
Error Boundary давно не «на стеке» ◀────────────────── ✕
→ Unhandled promise rejection в консолиError Boundary ловит ошибки, которые возникают во время работы React (рендер, синхронные части эффектов). Асинхронное продолжение выполняется позже, в отдельной задаче.
Четыре вида сбоев, которые нужно различать
| Сбой | Как проявляется | Что показать |
|---|---|---|
| Сеть недоступна | fetch отклоняется с TypeError | «Нет соединения» + повтор |
| HTTP-ошибка (404, 500) | response.ok === false (промис не отклоняется!) | По статусу: «Не найдено», «Сервис недоступен» |
| Неверный ответ | response.json() падает (пришёл HTML) или данные не по схеме | «Что-то пошло не так», отправить в мониторинг |
| Отмена | AbortError | Ничего — пользователь ушёл |
Типичная ошибка: finally старого запроса
// ✗ Индикатор загрузки «мигает» и гаснет раньше времени
useEffect(() => {
const controller = new AbortController();
setLoading(true);
fetch(`/api/search?q=${q}`, { signal: controller.signal })
.then((r) => r.json())
.then(setResults)
.catch(setError) // AbortError тоже попадёт сюда → «ошибка» при каждом вводе
.finally(() => setLoading(false)); // отменённый запрос выключит loading нового!
return () => controller.abort();
}, [q]);q="ре": запрос A ──── cleanup → abort ─✕ → finally: setLoading(false) ✗
q="реа": setLoading(true) → запрос B (ещё идёт), а loading уже falseПравильно
import { useEffect, useState } from "react";
export default function SearchResults({ q }) {
const [state, setState] = useState({ status: "idle", items: [], error: null });
useEffect(() => {
if (!q) return setState({ status: "idle", items: [], error: null });
const controller = new AbortController();
setState((s) => ({ ...s, status: "loading" }));
(async () => {
try {
const res = await fetch(`/api/search?q=${encodeURIComponent(q)}`, { signal: controller.signal });
if (!res.ok) throw new HttpError(res.status);
const items = await res.json();
if (!Array.isArray(items)) throw new Error("Неверный формат ответа");
setState({ status: "success", items, error: null });
} catch (error) {
if (controller.signal.aborted) return; // устарел — ничего не трогаем, даже loading
setState({ status: "error", items: [], error });
reportError(error); // в Sentry и т. п.
}
})();
return () => controller.abort();
}, [q]);
if (state.status === "error") return <ErrorMessage error={state.error} />;
if (state.status === "loading") return <p role="status">Ищем…</p>;
return <ul>{state.items.map((i) => <li key={i.id}>{i.title}</li>)}</ul>;
}
class HttpError extends Error {
constructor(status) {
super(`HTTP ${status}`);
this.status = status;
}
}
function ErrorMessage({ error }) {
if (error instanceof HttpError && error.status === 404) return <p>Ничего не найдено</p>;
if (error instanceof TypeError) return <p role="alert">Нет соединения. Проверьте интернет.</p>;
return <p role="alert">Сервис временно недоступен</p>;
}Ключевые моменты: одна проверка controller.signal.aborted закрывает все обновления устаревшего запроса; ошибки классифицированы; в мониторинг уходит каждая настоящая ошибка.
Передать ошибку в Error Boundary
// Вариант 1: сохранить и бросить при рендере
const [fatal, setFatal] = useState(null);
if (fatal) throw fatal; // ближайший Error Boundary покажет fallback
useEffect(() => {
loadCriticalConfig().catch(setFatal);
}, []);
// Вариант 2: react-error-boundary
import { useErrorBoundary } from "react-error-boundary";
const { showBoundary } = useErrorBoundary();
useEffect(() => {
loadCriticalConfig().catch(showBoundary);
}, [showBoundary]);Используй это для ошибок, после которых часть экрана не может работать, а не для ожидаемых ситуаций вроде «ничего не найдено».
Повторы
async function fetchWithRetry(url, { signal, retries = 2 } = {}) {
for (let attempt = 0; ; attempt++) {
try {
const res = await fetch(url, { signal });
if (res.status >= 500 && attempt < retries) throw new HttpError(res.status); // повторяем только 5xx и сеть
return res;
} catch (e) {
if (signal?.aborted || attempt >= retries || (e instanceof HttpError && e.status < 500)) throw e;
await new Promise((r) => setTimeout(r, 500 * 2 ** attempt)); // экспоненциальная задержка
}
}
}Повторять имеет смысл временные сбои (сеть, 502/503/504), но не 400/401/404. В TanStack Query это настраивается опцией retry.
Частые ошибки
useEffect(async () => …)— эффект вернёт промис вместо cleanup.- Нет
catch→ необработанный rejection и вечный спиннер. - Нет проверки
response.ok→.json()от страницы ошибки. AbortErrorпоказан пользователю как сбой.finallyустаревшего запроса меняет состояние нового.- Внутренний текст серверной ошибки показан пользователю.
Что важно помнить
- Error Boundary не ловит ошибки после
await— обрабатывай их сам. - Классифицируй сбои: сеть, HTTP-статус, неверный ответ, отмена.
- Все обновления состояния — только для актуального запроса.
- Фатальные ошибки можно перебросить в Error Boundary через state или
showBoundary. - Для реальных проектов — TanStack Query/SWR, где это уже решено.
Мини-шпаргалка
try { await … } catch { if (aborted) return; … }.if (!res.ok) throw new HttpError(res.status).- Отмена ≠ ошибка.
- В Boundary —
throwиз рендера илиshowBoundary. - Повторять 5xx и сеть, не 4xx.