배포 전에 꼭 확인해야 할 것들

배포 전 확인을 제대로 하면 배포 후 대부분의 문제를 피할 수 있다. 해야 할 일들을 체크리스트로 정리해뒀다.

빌드가 성공하는지 확인

로컬에서 빌드 에러가 없는지 먼저 본다. 그 다음 배포 환경의 빌드도 돌려본다. 로컬과 배포 환경의 Node 버전이나 의존성 버전이 다르면 배포에서만 에러가 날 수 있다.

npm run build

환경변수 설정 확인

배포 시스템에 환경변수가 제대로 들어가 있는지 확인한다. 로컬에서는 .env.local에 있던 값들이 배포 환경에도 있는지, 값이 정확한지 체크해야 한다.

특히 API 키나 데이터베이스 URL은 실수하기 쉽다. 배포 환경에서 환경변수를 확인할 수 없으면, 최소한 로그에 환경변수 로드 성공 메시지라도 남겨두면 문제 추적이 쉬워진다.

설정 파일 동기화

Next.js의 next.config.js, Webpack 설정, 빌드 플래그 같은 게 모두 맞는지 확인한다. 로컬에서 수정한 설정이 배포 환경에 반영됐는지 보는 것도 중요하다.

작은 기록 남기기

배포 전에 "배포 시간 18:30, 노드 버전 20.9.0, 빌드 성공" 같은 간단한 기록만 남겨도, 배포 후 문제가 생겼을 때 원인을 좁히기 훨씬 쉬워진다.