Логирование ошибок
На этой странице
Логи связывают пользовательский сбой с технической причиной: стеком, версией приложения, маршрутом и контекстом операции.
Вопрос
Что логировать в React-приложении и как не потерять ошибки за пределами Error Boundary?
Основная идея
Пользователь пишет «не открывается карточка», но у разработчика всё работает. Для расследования нужны сведения о конкретном сбое: какая версия была загружена, в каком блоке произошла ошибка, какой запрос завершился неуспешно. Одного текста Something went wrong для этого недостаточно.
Для ошибки React-поддерева componentDidCatch предоставляет componentStack, дополняющий обычный JavaScript stack. Для API-ошибок полезны безопасное имя операции, HTTP-статус и request ID. Sourcemaps помогают сопоставить минифицированный стек с исходниками; их публикацию и доступ настраивают осознанно.
Граница не охватывает все источники. SDK мониторинга обычно дополняет её обработкой глобальных error, unhandledrejection и серверными интеграциями. При этом не нужно бездумно отправлять всё подряд: персональные данные, токены и содержимое форм могут оказаться в URL, заголовках и сообщениях ошибок.
Пример
Пример для клиентского React-приложения с поддержкой JSX. API в примере возвращает JSON; его адрес замените на адрес своего сервера.
import { Component } from 'react';
function reportError(error, info) {
const event = {
message: error instanceof Error ? error.message : 'Неизвестная ошибка',
componentStack: info.componentStack,
release: 'training-1',
area: 'recommendations',
};
console.error('Событие мониторинга', event);
// В реальном приложении здесь вызов настроенного SDK с фильтрацией данных.
}
class ErrorBoundary extends Component {
state = { failed: false };
static getDerivedStateFromError() { return { failed: true }; }
componentDidCatch(error, info) { reportError(error, info); }
render() {
return this.state.failed ? <p role="alert">Блок недоступен</p>
: this.props.children;
}
}
function Widget() { throw new Error('Некорректный формат рекомендации'); }
export default function App() {
return <ErrorBoundary><Widget /></ErrorBoundary>;
}Пример показывает структуру события в консоли. Он не отправляет данные наружу и не является готовой настройкой мониторинга; SDK добавляют отдельно.
Откуда приходят ошибки и кто их ловит
Ошибка рендера в поддереве с Error Boundary → componentDidCatch / onCaughtError
Ошибка рендера без Error Boundary → onUncaughtError (React 19), корень размонтирован
Восстановимые ошибки (гидратация) → onRecoverableError
throw в обработчике, setTimeout → window "error"
Отклонённый промис без catch → window "unhandledrejection"
Ошибки API → свой http-клиент (статус, request id)Подключение на уровне корня (React 19)
import { createRoot } from "react-dom/client";
const root = createRoot(document.getElementById("root"), {
onCaughtError(error, info) {
report(error, { componentStack: info.componentStack, handled: true });
},
onUncaughtError(error, info) {
report(error, { componentStack: info.componentStack, handled: false });
},
onRecoverableError(error, info) {
report(error, { level: "warning" });
},
});
root.render(<App />);
window.addEventListener("unhandledrejection", (e) => report(e.reason, { source: "promise" }));С сервисом мониторинга (на примере Sentry)
import * as Sentry from "@sentry/react";
Sentry.init({
dsn: import.meta.env.VITE_SENTRY_DSN,
release: import.meta.env.VITE_RELEASE, // связать ошибку с версией
environment: import.meta.env.MODE,
sendDefaultPii: false, // не отправлять персональные данные
beforeSend(event) {
delete event.request?.cookies; // дополнительная фильтрация
return event;
},
});
const root = createRoot(container, {
onUncaughtError: Sentry.reactErrorHandler(),
onCaughtError: Sentry.reactErrorHandler(),
onRecoverableError: Sentry.reactErrorHandler(),
});Что включать в событие
| Поле | Зачем |
|---|---|
message, stack (+ source maps) | Где упало в исходниках |
componentStack | В каком компоненте |
release, environment | Связь с деплоем, регрессии |
| Маршрут, действие пользователя (breadcrumbs) | Как воспроизвести |
| HTTP-статус, request id | Связать с логами бэкенда |
| Браузер, ОС | Проблемы конкретных платформ |
| ✗ Токены, пароли, содержимое форм, email | Нельзя — утечка данных |
Что важно помнить
- Сбой отправки лога не должен вызывать новую цепочку аварий.
- Группируйте дубликаты, учитывайте версию релиза и частоту затронутых пользователей.
- Для обработанных и необработанных ошибок React 19 доступны также соответствующие callbacks корня; избегайте двойной отправки одного события.
Мини-шпаргалка
Ошибка + stack + componentStack + release + безопасный контекст. Пользователю → понятное сообщение, разработчику → диагностика.
Документация
Перехват ошибок через Error Boundary. Обработка ошибок корня.