빌드 중 게시가 실패하는 경우
- Publishing과 실패한 배포의 로그를 여세요.
- 마지막 “build failed” 메시지만 보지 말고 조치할 수 있는 첫 번째 오류를 찾으세요.
- 빌드 명령, 종속성 설치, 참조된 파일 경로를 확인하세요.
- 게시에 필요한 환경 변수가 구성되어 있는지 확인하세요. Preview가 작동한다고 해서 프로덕션 구성이 검증되는 것은 아닙니다.
- 확인된 문제를 수정하고 다시 게시한 다음 새 로그를 비교하세요.
빌드는 성공하지만 시작 또는 상태 점검이 실패하는 경우
실행 명령이 종료되는 빌드 프로세스가 아니라 계속 실행되는 서버를 시작하는지 확인하세요. 웹 서버의 경우 바인드 주소와 포트 구성을 확인하세요.localhost에서만 수신 대기하지 말고 외부 연결을 받아야 합니다.
명시적인 포트 매핑을 변경하기 전에 포트 구성을 읽어보세요. 서버가 요청을 받기 시작하기 전에 누락된 프로덕션 시크릿, 데이터베이스 오류, 예외가 있는지 시작 로그를 확인하세요.
배포를 통과시키려고 인증이나 애플리케이션 검사를 무분별하게 제거하지 마세요. 실패하는 라우트나 시작 종속성을 진단하세요.
게시된 앱이 500 또는 502를 반환하는 경우
- 요청 하나를 재현하고 그 시각과 영향을 받은 URL을 기록하세요.
- 해당 시각 전후의 런타임 로그에서 예외, 충돌, 재시작을 확인하세요.
- 필요한 데이터베이스나 외부 API에 연결할 수 있는지 확인하세요.
- 실패를 모니터링의 CPU 및 메모리 사용량과 비교하세요.
replit.app URL은 작동하지만 커스텀 도메인이 실패한다면 도메인 가이드를 사용하세요. 로그인만 실패한다면 인증 가이드를 사용하세요.