Next.js 프로덕션 환경을 위한 타입 기반 에러 핸들링과 구조적 로깅 전략

Context

단순 try/catch 기반의 파편화된 에러 처리 방식. 사용자에게 불친절한 에러 메시지 노출. 이슈 발생 후 사용자 제보에 의존하는 수동적인 장애 감지 구조.

Technical Solution

• AppError 클래스를 상속받는 NotFoundError, ValidationError 등 도메인별 Typed Error 체계 구축
• AppError 인스턴스 여부에 따라 Warn 및 Error 레벨을 구분하는 중앙 집중형 API 에러 핸들러 설계
• Pino를 활용하여 서비스명, 환경 정보, RequestId를 포함하는 JSON 형식의 Structured Logging 도입
• Next.js Error Boundary를 통한 클라이언트 사이드 런타임 에러 캡처 및 사용자 복구 UI 제공
• Redis 카운터를 활용한 5xx 에러 발생 빈도 추적 및 임계치 기반의 자동 Alerting 시스템 구축

Key Takeaway

에러 처리를 단순한 예외 캡처가 아닌 타입 정의부터 로깅, 알림까지 이어지는 하나의 통합 시스템으로 설계하는 관점이 중요함.