# [[React Error Boundaries]]

## 📌 Brief Summary
React Error Boundaries는 하위 컴포넌트 트리의 렌더링, 수명 주기 메서드 또는 생성자에서 발생하는 JavaScript 에러를 포착하는 특수한 클래스 컴포넌트입니다 [1, 2]. 이 메커니즘은 앱 전체가 다운되거나 빈 화면(white screen of death)이 표시되는 것을 방지하고 대신 대체 UI(fallback UI)를 표시하도록 돕습니다 [1, 2]. 본질적으로 React 컴포넌트를 위한 `try-catch` 블록처럼 작동하여 프론트엔드 애플리케이션의 안정성과 사용자 경험을 높여줍니다 [2, 3].

## 📖 Core Content
* **작동 원리 및 제약 사항:** 
  Error Boundaries는 클래스 컴포넌트로만 생성할 수 있으며, 오류 발생 후 대체 UI를 렌더링하기 위한 `static getDerivedStateFromError()`나 오류 정보를 기록하기 위한 `componentDidCatch()` 생명주기 메서드 중 하나 이상을 정의해야 작동합니다 [3-5]. 단, 이벤트 핸들러, 비동기 코드(예: `setTimeout`), 서버 사이드 렌더링(SSR), 혹은 Error Boundary 자체에서 발생한 에러는 포착하지 못합니다 [4, 5]. 이벤트 핸들러의 경우 표준 JavaScript의 `try/catch` 문을 직접 사용해야 합니다 [5-7].
  
* **전략적 배치 및 모범 사례:** 
  애플리케이션 전체를 단일 Error Boundary로 감싸기보다는, 불안정하거나 중요한 UI 섹션(예: 타사 위젯, 차트, 복잡한 폼 등)을 개별적으로 감싸는 것이 권장됩니다 [8-10]. 예를 들어, 사이드바나 메시지 입력창 중 한 곳이 충돌하더라도 개별적인 Error Boundary가 설정되어 있다면 나머지 UI 부분은 계속 상호작용 가능한 상태로 유지될 수 있습니다 [8, 11].

* **프로덕션 환경 적용 및 복구성 향상:** 
  프로덕션 환경에서는 Error Boundaries를 Sentry나 LogRocket과 같은 로깅 및 모니터링 도구와 통합하여 에러 세부 정보를 캡처하는 것이 모범 사례로 꼽힙니다 [10]. React 16부터는 Error Boundary에 의해 포착되지 않은 에러는 전체 React 컴포넌트 트리의 마운트 해제(unmounting)를 초래하여 심각한 문제를 일으킬 수 있으므로, 적절한 에러 경계 설정은 확장 가능하고 견고한 애플리케이션을 유지하는 데 필수적입니다 [9, 12].

## 🔗 Knowledge Connections
- **Related Topics:** [[Class Components]], [[Fallback UI]], [[Frontend Debugging]], [[Component Lifecycle]]
- **Projects/Contexts:** [[Sentry/LogRocket Monitoring]], [[Scalable React Architecture]], [[Error Handling in 2025]]
- **Contradictions/Notes:** Error Boundaries는 렌더링 오류를 잡기 위해 설계된 훌륭한 기능이지만, 함수형 컴포넌트로는 직접 만들 수 없으며 컴포넌트의 이벤트 핸들러 내의 오류는 포착하지 못하므로 이벤트 핸들러는 일반적인 `try/catch`로 별도 처리해야 합니다 [3, 5, 6].

---
*Last updated: 2026-04-26*