re:re:actable
Урок 055 минут чтения

Асинхронные ошибки в 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.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам