웹 개발 중 볼륨 문제로 막힐 때

웹 개발을 하다 보면 화면 하나만 봐서는 뭐가 문제인지 알 수 없는 경우가 있다. 로그와 응답을 함께 봐야 원인이 보인다.

상황을 먼저 요약해 두기

문제 해결의 흐름을 먼저 끊어서 본다. 특히 설정이 애매하면, 다른 부분을 고쳐도 결과가 안 바뀐다.

증거를 모아보기

빌드 결과부터 확인하면, 불필요한 변경을 줄일 수 있다. 작은 확인이 쌓이면, 원인 후보가 자연스럽게 줄어든다.

• 먼저 볼 값: 빌드 결과
• 같이 비교할 값: 정상 상태와 비교
• 남겨둘 기록: 빌드 명령어, 에러 코드, 수정 내역

설정을 다시 확인해 보기

가능한 원인들을 하나씩 제외해 가면서 찾는 게 빠르다. 사용자 영향부터 확인해 보자.

npm run build

이 명령 하나로 대부분의 빌드 에러는 드러난다.

가장 작은 실험부터 시작하기

문제 해결의 흐름을 먼저 끊어서 본다. 특히 재현 조건이 애매하면, 다른 부분을 고쳐도 결과가 안 바뀐다.

한 부분씩 작게 수정하고 테스트하면, 어디가 문제인지 명확해진다.

사용자에게 미치는 영향

문제가 생기면, 먼저 사용자가 실제로 느끼는 불편함이 무엇인지 파악하자. 기술적 에러와 사용자 경험은 다를 수 있다.

다음 순서로 체크하자:

1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해 본다.
3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

배운 점을 기록하기

작은 확인을 남겨 두면, 다음 문제를 훨씬 짧게 처리할 수 있다. 관련 기록을 남기는 습관이 가장 중요하다.