디버깅 수렴 절차

증상을 문장화한다

언제, 어떤 입력에서, 기대와 실제가 어떻게 다른지 기록합니다.

symptom

계정, 데이터, 브라우저, 네트워크, 시간 조건을 맞춰 같은 실패를 반복시킵니다.

reproduce

중단점과 watch로 값이 처음 틀어지는 줄, 요청, 상태 전이를 확인합니다.

divergence

원인이 확인되면 최소 수정과 함께 테스트나 체크리스트로 같은 문제가 돌아오지 않게 합니다.

guard

Network

payload와 status가 기대와 맞는지 확인 UI 오류처럼 보여도 응답 schema 변화가 원인일 수 있습니다.

경계

State

상태 소유자와 갱신 순서를 확인 이전 값으로 렌더링되는 문제는 비동기 업데이트와 캐시를 함께 봅니다.

data

Render

DOM 결과와 CSS 적용을 확인 데이터는 맞는데 화면이 틀리면 조건부 렌더링과 스타일 우선순위가 후보입니다.

view

가설 하나 한 번에 하나의 가설만 확인해야 관찰 결과가 의미를 가집니다.

로그 제거 임시 로그와 디버거 문은 수정 후 반드시 정리합니다.

재현 문서 다시 발생했을 때 바로 따라 할 수 있는 최소 재현 경로를 남깁니다.

증상: 저장 후 목록에 보이지 않음
재현: Chrome, throttling fast 3G, 새 글 작성
첫 불일치: POST 성공, GET 목록 캐시가 이전 값