오류 원인 분류
오류 진단은 재현 가능한 단서에서 시작한다
에러 메시지, 실행 환경, 최근 변경을 함께 모으면 원인을 더 빠르게 좁힐 수 있다.
유형별 첫 확인 지점
debug route타입/임포트
경로, 대소문자, tsconfig alias, 누락된 타입 패키지를 확인한다.
Hook/Client
훅 호출 위치와 use client 선언이 컴포넌트 경계와 맞는지 본다.
Fetch/Env
환경 변수, API 응답 구조, 직렬화 가능한 데이터인지 먼저 확인한다.
Hydration
서버 HTML과 클라이언트 렌더 결과가 달라지는 코드를 분리한다.
Deploy
빌드 로그, 런타임 로그, Node 버전 차이를 운영 환경 기준으로 본다.
메시지 수집
범위 축소
로컬 재현
수정 검증
원인 기록
해결책을 먼저 적용하기보다 같은 오류를 반복해서 재현할 수 있는 최소 조건을 찾으면, 수정 후 검증도 훨씬 명확해진다.