배포 전에 빌드 에러를 점검하는 법

혼자 개발할 때는 확인한 값과 바꾼 값을 따로 남기는 습관이 중요하다. 빌드 에러가 반복되는 패턴을 찾으면 원인 추적이 훨씬 빨라진다.

목표부터 명확히 하기

웹 개발 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

현재 상태 파악하기

빌드 주변 문제가 반복되면 확인 순서를 고정해두는 게 좋다. 감으로 접근하면 같은 실수를 반복한다.

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

설정을 비교하기

문제 해결은 한 단계씩 진행해야 한다. 설정이 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다.

npm run build

수정 순서 정하기

문제 해결 작업은 로컬과 배포의 차이가 자주 숨어 있다. 환경 차이까지 적어두면 원인 추적이 쉬워진다.

사용자 영향 먼저 확인하기

바로 수정하기 전에 사용자 영향부터 확인하면 불필요한 변경을 줄일 수 있다. 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어난다.

최종 검증 체크리스트

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

다음 액션

바로 수정하기 전에 재현 조건부터 확인하면 불필요한 변경을 줄일 수 있다. 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어난다. 작은 확인을 남겨두면 다음 문제를 훨씬 짧게 처리할 수 있다.