오류 경계
componentDidCatch와 getDerivedStateFromError를 사용해 클래스 기반 오류 경계를 구현하고, 처리되지 않은 렌더링 오류로 전체 앱이 중단되지 않도록 합니다.
오류 경계은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
오류 경계가 필요한 이유
렌더링 중, 생명 주기 메서드 안에서 또는 생성자에서 처리되지 않은 오류가 발생하면 기본적으로 전체 React 트리가 중단됩니다. 오류 경계는 하위 트리에서 이러한 오류를 포착하고 대신 대체 화면을 렌더링할 수 있게 합니다.
클래스 컴포넌트만 사용
오류 경계는 반드시 클래스 컴포넌트여야 합니다(2026년에도 여전히 그렇고, 아직 훅으로 대체할 방법은 없습니다). useErrorBoundary 훅은 react-error-boundary 같은 라이브러리에서 제공합니다.
getDerivedStateFromError
자손 컴포넌트에서 오류가 발생할 때 호출되는 정적 메서드입니다. 대체 화면 렌더링을 시작하는 상태 업데이트를 반환합니다.
class ErrorBoundary extends React.Component {
state = { hasError: false };
static getDerivedStateFromError(error) {
return { hasError: true };
}
render() {
if (this.state.hasError) {
return <h1>Something went wrong.</h1>;
}
return this.props.children;
}
}componentDidCatch로 로그 기록하기
componentDidCatch를 사용해 서비스(Sentry, Datadog)에 오류를 기록하십시오. 이 메서드는 오류와 React 컴포넌트 스택을 모두 받습니다.
componentDidCatch(error, errorInfo) {
Sentry.captureException(error, {
contexts: { react: { componentStack: errorInfo.componentStack } }
});
}앱 루트 감싸기
빈 화면이 표시되는 상황을 방지하려면 최상위 App을 오류 경계로 감싸십시오.
<ErrorBoundary fallback={<GlobalErrorPage />}>
<App />
</ErrorBoundary>경로 또는 위젯별 세분화된 경계
전역 경계 하나는 최소한의 구성입니다. 한 영역의 충돌로 전체 앱이 빈 화면이 되지 않도록 경로별 경계를 추가하십시오.
<Routes>
<Route path="/" element={<Home />} />
<Route path="/dashboard" element={
<ErrorBoundary fallback={<DashboardError />}>
<Dashboard />
</ErrorBoundary>
} />
</Routes>오류 경계가 포착하지 못하는 것
경계는 다음과 같은 오류를 포착하지 못합니다. 이벤트 처리기의 오류, 비동기 코드의 오류(setTimeout, 프라미스), SSR 중 발생한 오류, 경계 자체에서 발생한 오류입니다. 이러한 경우에는 try/catch를 사용하십시오.
이벤트 처리기 오류
이벤트 처리기를 try/catch로 감싸고 수동으로 reportError 함수를 호출하십시오.
function Button() {
function onClick() {
try {
riskyOperation();
} catch (err) {
reportError(err);
toast.error('Something went wrong');
}
}
return <button onClick={onClick}>Click</button>;
}react-error-boundary 라이브러리
커뮤니티 패키지 react-error-boundary는 함수 컴포넌트에 적합한 API와 초기화 기능을 제공합니다.
import { ErrorBoundary } from 'react-error-boundary';
<ErrorBoundary
fallbackRender={({ error, resetErrorBoundary }) => (
<div>
<p>Error: {error.message}</p>
<button onClick={resetErrorBoundary}>Try again</button>
</div>
)}
onReset={() => refetch()}
>
<DataView />
</ErrorBoundary>복구 시 상태 초기화
재시도 버튼이나 라우트 변경처럼 복구할 방법을 제공하십시오. 대체 화면이 계속 표시되지 않도록 경계의 상태를 초기화해야 합니다.
class ErrorBoundary extends React.Component {
state = { hasError: false };
static getDerivedStateFromError() { return { hasError: true }; }
reset = () => this.setState({ hasError: false });
render() {
if (this.state.hasError) {
return <button onClick={this.reset}>Retry</button>;
}
return this.props.children;
}
}개발 환경과 프로덕션 환경
개발 환경에서는 경계를 사용하더라도 React가 빨간색 오류 오버레이를 계속 렌더링합니다. 이는 의도된 동작입니다. 프로덕션 환경에서는 경계의 대체 화면만 표시됩니다.
모범 사례
1) 앱 루트에 전역 경계를 둡니다. 2) 라우트별 경계를 둡니다. 3) 서로 독립적인 위젯 주위에 세분화된 경계를 둡니다. 4) 항상 추적 서비스에 기록합니다. 5) 복구 작업(재시도, 홈으로 이동)을 표시합니다. 6) 오류를 조용히 무시하지 않습니다.
빠른 확인
React 오류 경계가 포착하지 못하는 오류 유형은 무엇인가요?
복습: 오류 경계
static getDerivedStateFromError와 componentDidCatch를 사용하는 클래스 컴포넌트입니다. 하위 트리를 감싸 렌더링 중 발생한 오류를 포착합니다. 이벤트 처리기, 비동기 코드, SSR에서 발생한 오류는 포착하지 못합니다. 앱 루트에 전역 경계를 두고, 라우트별 경계와 위젯별 경계도 추가합니다. Sentry에 기록하고 복구 작업을 제공합니다. 더 깔끔한 사용 방식을 원한다면 react-error-boundary 라이브러리를 사용하십시오.
자주 묻는 질문
“오류 경계” 강의는 무료인가요?
네 — “오류 경계” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“오류 경계”에서 뭘 배우나요?
componentDidCatch와 getDerivedStateFromError를 사용해 클래스 기반 오류 경계를 구현하고, 처리되지 않은 렌더링 오류로 전체 앱이 중단되지 않도록 합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Frontend Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“오류 경계” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.