초보가 배포 전에 놓치기 쉬운 체크리스트

로컬에서는 괜찮던 설정도 배포 환경에서는 다르게 보인다. 초보자일수록 이 차이를 놓친다.

화면 하나만 보지 말고, 로그와 설정을 함께 봐야 한다. 그래야 진짜 원인이 보인다.

문제의 경계 파악

어느 부분이 문제인가? 프론트엔드? 백엔드? 데이터베이스? 이것부터 나눠서 생각하자.

로컬과 배포 환경 비교

로컬과 배포 환경이 다른 부분들:

• 환경 변수 설정
• 데이터베이스 설정
• 외부 API 엔드포인트
• 빌드 최적화 여부

설정 확인

npm run build
# 빌드 후 결과 파일 크기와 에러 메시지 확인

빌드가 정상적으로 완료되었는가? 빌드 크기가 예상과 다르진 않은가?

응답 확인하기

배포 환경에서 API 응답이 정상인가? 외부 API 키는 제대로 설정되었는가?

사용자 영향 확인

실제 사용자가 느낄 수 있는 차이가 있는가? 예를 들어 페이지 로딩 속도, 에러 메시지, 기능 정상 여부.

위험한 수정 피하기

배포 후 바뀐 게 없다면, 한 가지씩만 고쳐보자. 여러 개를 동시에 고치면 뭐가 문제인지 알 수 없다.

한 번에 여러 설정을 바꾸지 않는 것만으로도 원인 추적이 쉬워진다.