웹 개발 버그 확인할 때 처음 봐야 할 것들

처음부터 정답을 맞히려고 하지 말 것

버그 보고가 들어오면 바로 코드를 고치려고 할 수 있다. 하지만 처음부터 정답을 찾으려고 하면 오히려 확인 시간이 더 길어진다. 먼저 문제를 정확히 파악하는 게 빠르다.

사용자가 보는 모습과 개발자가 보는 신호

사용자가 보는 화면과 개발 환경의 신호는 다르다. 문제를 이해하려면 둘 다 봐야 한다.

먼저 봐야 할 것:

• 사용자 영향 범위가 얼마나 되는지
• 로컬과 운영 환경의 차이
• 명령 출력, 응답 코드, 수정한 설정

빌드 과정부터 확인하자

npm run build

빌드가 제대로 되는지 보고, 빌드 결과와 로그를 기록해둔다. 로컬에서는 잘 되는데 배포 환경에서 안 되는 경우가 많으니까.

확인 체크리스트

1. 같은 조건에서 증상이 다시 나오는지 확인한다
2. 로그나 응답에서 뭐가 바뀌었는지 한 줄로 정리한다
3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다

작은 기록이 다음 확인을 빠르게 한다

이번에 문제를 해결했으면 어떤 값이 달라졌는지 설명할 수 있게 기록해둔다. 다음에 비슷한 증상이 나올 때 훨씬 짧게 처리할 수 있다.