배포 전에 확인해야 할 웹 개발 체크리스트

배포하기 전에는 여러 군데를 동시에 봐야 한다. 화면만 보고 괜찮다고 판단했다가 배포 후에야 문제를 발견하면 복구하는 게 더 오래 걸린다.

핵심은 문제의 원인을 한 가지에만 집중하지 말고 전체 흐름에서 찾아내는 것이다. 재현 조건, 로그, 응답 중 눈으로 확인할 수 있는 값들을 먼저 수집해야 한다.

문제를 크게 보기

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

확인할 주요 항목

웹 개발 쪽 문제는 화면만 봐서는 놓치는 게 많다. 다음 항목들을 함께 확인해야 한다:

• 먼저 볼 값: 빌드 결과
• 같이 비교할 값: 정상 상태와의 차이
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

빌드 확인

npm run build

확인 순서

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

검증 루틴

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

정리

한 번에 여러 설정을 바꾸지 않는 것만으로도 원인 추적이 훨씬 쉬워진다. 관련 기록을 짧게라도 남겨두면 다음 배포 때 확인이 훨씬 빨라진다.