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

배포를 앞두고 있는데 뭘 확인해야 할지 모르겠다면, 이런 식으로 체계적으로 하나씩 확인해보자. 가장 흔한 실수들을 체크포인트로 만들었다.

로컬에서 먼저 빌드 시도

배포 환경에서 벌어질 일을 로컬에서 미리 경험하는 게 좋다.

npm run build

빌드 로그에 warning이나 error가 있으면 지금 해결해야 한다. 배포 후에는 훨씬 복잡해진다.

환경변수 확인

로컬 .env.local과 배포 환경의 환경변수가 정말 다른지 확인한다.

• API 엔드포인트가 다른가? (로컬 localhost vs 배포 서버)
• 키나 토큰 같은 민감한 값들이 제대로 설정됐는가?
• 새로 추가한 환경변수가 배포 설정에도 들어갔는가?

빌드 결과 확인 (정적 파일이 있는 경우)

Next.js 등의 정적 빌드를 했다면, .next 또는 dist 폴더를 확인해본다.

• 크기가 비정상적으로 크지 않은가?
• 불필요한 파일이 포함되진 않았는가?
• 소스맵이 배포 버전에 포함되면 보안 문제가 될 수 있다.

사용자가 보는 화면 테스트

가장 기본적인 페이지들을 직접 열어본다.

• 홈페이지 로딩되는가?
• 로그인/회원가입 같은 주요 흐름이 동작하는가?
• 모바일에서도 정상인가? (DevTools에서 device emulation으로 확인)

최신 커밋이 정말 배포될 커밋인가?

배포 스크립트나 CI/CD 설정이 올바른 브랜치에서 코드를 가져가는지 확인한다. 어제 완성한 기능이 배포되지 않는 경우가 종종 있다.

git log -1
git branch

캐시 때문에 헷갈리지 않기

배포 후 새 코드가 안 보이는 건 대부분 브라우저 캐시 때문이다. 먼저 private/incognito 창에서 열어보거나 Ctrl+Shift+Del로 캐시를 완전히 지워보자.

롤백 계획 미리 세우기

뭔가 심각하게 잘못됐을 때 1분 안에 이전 버전으로 돌릴 수 있는지 확인한다. 배포 직후는 긴장이 풀려서 당황하기 쉽다. 미리 계획해두면 침착할 수 있다.