문제 해결

배포, GitHub 권한, 앱 시작, 환경변수와 도메인 문제를 순서대로 확인합니다.

이 문서에서 다루는 내용

배포가 실패했을 때

1
실패 단계를 확인합니다
BUILDING에서 실패했는지, 앱 실행이나 공개 URL 확인에서 실패했는지 먼저 구분합니다.
2
로그의 마지막 원인을 읽습니다
긴 설치 로그의 첫 경고보다 마지막 오류와 그 직전 문맥을 우선 확인합니다.
3
설정 또는 코드를 한 가지씩 고칩니다
Root Directory, 실행 명령, PORT, 필수 환경변수와 프레임워크 엔트리포인트를 확인합니다.
4
새 배포로 검증합니다
환경변수와 설정 변경은 기존 실행 버전에 반영되지 않으므로 새 배포가 필요합니다.

증상	확인할 것
저장소를 가져올 수 없음	GitHub App 설치 저장소, private 권한, 현재 GitHub 계정
앱 폴더나 package.json을 찾지 못함	Root Directory가 실제 앱 폴더인지 확인
Python 엔트리포인트를 찾지 못함	Start Command의 모듈 경로와 Procfile 확인
컨테이너가 시작 직후 종료	start script, Start Command, 필수 환경변수, 런타임 로그
공개 URL 확인 실패	PORT, 0.0.0.0 바인딩, Healthcheck Path
환경변수 변경이 보이지 않음	저장 이후 새 배포를 시작했는지 확인
DATABASE_URL이 없음	DB가 ACTIVE인지, 해당 서비스가 DB에 연결되어 있는지 확인
도메인이 연결 대기	화면의 CNAME/A 대상, DNS 전파, 서비스 ACTIVE 상태

Python 실패 원인이 다르게 보일 때

일부 Python 배포에서는 요약 메시지가 package.json 문제를 먼저 가리킬 수 있습니다. 빌드 로그의 마지막 오류를 확인하고 Procfile, Start Command의 모듈 경로와 실행 파일이 실제 앱 위치와 일치하는지 함께 확인하세요.

이 문서에서