근거 지도

개발자 도구 단서 추적

Console, Network, Elements에서 끝내지 말고 어떤 파일과 런타임을 확인할지 바로 연결해야 디버깅 속도가 빨라집니다.

Console

클라이언트 예외

스택 트레이스와 컴포넌트 이름을 보고 use client 영역의 상태와 이벤트 핸들러를 확인합니다.

Client Component
Network

API 응답 이상

상태 코드, 응답 본문, 대기 시간을 비교해 Route Handler 또는 Server Action 문제를 나눕니다.

app/api 또는 action
Elements

DOM과 스타일 차이

실제 클래스, 계산된 스타일, 서버 HTML 차이를 보고 CSS 또는 Hydration 원인을 찾습니다.

layout, page, CSS
Sources

로직 흐름 중단

브레이크포인트와 호출 스택으로 이벤트 이후 어떤 함수가 값을 바꾸는지 추적합니다.

handler와 hook
Application

세션과 캐시 문제

쿠키, 로컬 스토리지, 캐시 스토리지를 비워 인증 상태와 오래된 데이터를 분리합니다.

auth, storage
Performance

긴 작업과 렌더링

타임라인에서 긴 작업, 레이아웃 계산, 페인트 비용을 골라 최적화 위치를 정합니다.

렌더링 경로
사용법

단서, 의심 파일, 재현 절차, 수정 결과를 같은 이슈나 커밋 메시지에 남기면 다음 오류에서도 비교 기준이 됩니다.