← 전체 글로 돌아가기

웹 개발

배포 후 네트워크 오류 빠르게 진단하기

배포 후 네트워크 문제를 진단하려면 재현 조건부터 먼저 잡아야 한다.

배포 후 문제가 생겼다면 검색해서 들어온 상황이라 바로 재현 조건부터 잡는 편이 빠르다.

핵심은 한 가지에만 붙잡지 말고 전체 문제 해결 흐름에서 원인을 찾아내는 것이다. 재현 조건, 로그, 응답을 먼저 수집해야 한다.

배포의 목표

바로 수정하기 전에 재현 조건부터 확인하면 불필요한 변경을 줄일 수 있다. 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어든다.

현재 상태 파악

정상 상태를 먼저 정해두는 게 좋다. 그래야 로그 결과가 맞는지 아닌지를 빠르게 판단할 수 있다:

  • 먼저 볼 값: 로그
  • 같이 비교할 값: 정상일 때의 상태
  • 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

설정 비교

npm run build

수정 순서

문제 해결의 흐름을 먼저 끊어서 봐야 한다. 빌드 결과가 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다.

사용자 영향과 확인 결과

배포 문제가 반복된다면 확인 순서를 정해두는 편이 낫다. 감으로 접근하면 같은 실수를 반복하게 된다.

검증 과정

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

다음 액션

해결 자체보다 어떤 값이 달라졌는지 설명할 수 있는 상태가 더 중요하다. 기록을 남겨두면 다음 확인이 훨씬 빨라진다.