배포 전 체크리스트

 

필수

• 로컬에서 

  npm run build

   또는 

  yarn build

  로 프로덕션 빌드 테스트
  • 개발 모드(

    dev

    )가 아닌, 실제 배포 환경 빌드로 오류가 없는지 확인
• 환경변수(.env) 누락/오타 확인
  • 배포 서버에도 필요한 환경변수가 모두 세팅되어 있는지 확인
• API/DB 연결 주소가 배포 환경에 맞는지 확인
  • 예: 로컬 DB가 아니라, 실제 MongoDB Atlas 주소를 사용하고 있는지

권장

• 불필요한 콘솔 로그/디버깅 코드 제거
• 의존성 패키지 최신화 및 불필요한 패키지 제거
• 정적 파일/이미지/환경설정 파일 포함 여부 확인
• CORS, HTTPS, 도메인 등 배포 환경 특화 설정 확인
• 배포 후 health check(정상 동작 확인) 자동화

---

3. 배포 후 자주 발생하는 문제

• 환경변수 누락/오타
• 빌드 시 타입 에러/런타임 에러
• 경로 대소문자 문제(로컬은 대소문자 구분X, 서버는 구분O)
• 외부 API, DB, 인증 등 네트워크 접근 문제
• 서버/클라우드의 파일 권한, 포트, 리소스 제한 등

---

4. 지금 할 수 있는 것

1. Problems 패널의 3개 문제 내용을 복사해서 알려주세요!
   → 바로 원인 분석 & 수정해드립니다.

2. npm run build

    명령을 실행해서 빌드 에러가 없는지 확인해보세요.
   → 에러가 있다면 로그를 알려주시면 해결해드릴 수 있습니다.
3. 위 체크리스트 중 궁금한 점 있으면 말씀해 주세요.

---

요약

• Problems 패널의 에러/워닝부터 0개로 만들기!

• npm run build

  로 프로덕션 빌드 테스트
• 환경변수, 경로, 외부 서비스 연결 등 꼼꼼히 점검

Problems 패널의 구체적인 에러/워닝 메시지나, 빌드 에러 로그를 알려주시면
즉시 해결책을 드릴 수 있습니다!
준비가 끝나면, 배포도 안전하게 도와드릴게요.

Feedback submitted

 

Generating