실전에서 자주 겪는 배포 오류와 해결법

1. ChatGPT에서 repository가 안 보임

원인: 새 private repository가 GitHub app 허용 목록에 없거나 검색 index 반영이 늦음.

해결: ChatGPT 설정의 GitHub app에서 repository를 다시 선택하고 몇 분 뒤 재시도합니다.

원인: 연결 여부와 제공되는 action은 별개입니다. create_repository action이 없으면 새 저장소 버튼은 직접 눌러야 합니다.

해결: 사용자가 빈 repository를 한 번 만들고, 그다음 기존 repository 파일 작업을 자동화합니다.

원인: output directory가 실제 index.html 위치와 다름.

해결: public/index.html이면 Cloudflare output을 public으로 지정합니다.

원인: production URL이 아니라 오래된 preview/temporary URL을 열었거나 browser cache가 남음.

해결: Cloudflare 최신 deployment의 domain을 확인하고 Ctrl + F5로 새로고침합니다.

원인: 정적 Pages에 화면만 배포했고 API·Database가 연결되지 않음.

해결: login과 저장이 필요한 기능은 Workers + D1, 파일은 R2로 분리합니다.

원인: 환경변수와 source code의 역할을 구분하지 않음.

해결: token은 Cloudflare Secret이나 GitHub Actions Secret에만 넣고, 노출된 token은 즉시 재발급합니다.

원인: 설정 파일의 main entry가 예전 worker file을 가리킴.

해결: 실제 배포 entry, branch, URL 세 가지를 함께 확인합니다. “code 수정 완료”와 “그 code가 실제 배포됨”은 다른 단계입니다.