AI로 화면은 만들었는데 주소가 없다면: 배포에서 멈추는 7곳과 확인 방법

ZERO ONE Builder 제작팀(ZERO ONE IT)이 쓴 가이드입니다. 최종 갱신 2026-09-25.

화면은 나왔습니다. 주소는 안 나왔습니다.

배포에서 멈추는 자리는 대개 아래 7곳 중 하나입니다. 원인보다 증상이 먼저 보이니, 증상부터 찾으세요.

1. 코드가 내 컴퓨터에만 있다

• 증상: 호스팅 화면이 "저장소를 연결하세요"라고만 한다.
• 원인: 대부분의 호스팅은 GitHub 같은 저장소에서 코드를 가져간다.
• 확인: 내 코드의 저장소 주소가 있는가. 없다면 저장소를 먼저 만든다. 폴더를 직접 올리는 방식을 지원하는 호스팅도 있다. 우리 시안은 Cloudflare Pages에 폴더를 직접 올렸다.

2. 서버가 필요한 서비스인지 모른다

• 증상: 올렸더니 화면은 뜨는데 입력한 내용이 새로고침하면 사라진다.
• 원인: 화면만 있는 사이트(정적 사이트)와, 저장·로그인·결제가 있는 서비스는 필요한 것이 다르다.
• 확인: 두 질문에 답한다. "새로고침해도 입력한 게 남아야 하나?" "다른 사람도 그 내용을 봐야 하나?" 둘 다 예라면 데이터베이스가 필요하다.

3. 배포는 성공이라는데 빈 화면이다

• 증상: 호스팅은 성공 표시, 주소를 열면 흰 화면이나 404.
• 원인: 빌드 결과물이 생기는 폴더 이름과 호스팅에 적은 출력 폴더가 다르다. dist, build, out이 흔하다.
• 확인: 내 컴퓨터에서 빌드한 뒤 새로 생긴 폴더 이름을 호스팅 설정과 한 글자씩 대조한다.

4. 내 컴퓨터에선 되는데 배포본에서 데이터가 안 뜬다

• 증상: "API key missing" 같은 오류, 또는 목록이 비어 있다.
• 원인: 비밀값을 담은 .env 파일은 보통 저장소에 올라가지 않는다. 올라가면 안 된다. 그래서 호스팅 설정 화면에 같은 이름으로 따로 넣어야 한다.
• 확인: 호스팅의 환경변수 화면에서 이름 철자를 대조하고, 넣은 뒤 다시 배포한다. 넣기만 하고 재배포하지 않으면 반영되지 않는 곳이 많다.
• 경고: 비밀키를 코드나 공개 저장소에 넣지 않는다. 브라우저에 그대로 전달되는 변수(예: 이름이 NEXT_PUBLIC_으로 시작하는 것)에 비밀키를 넣지 않는다.

5. 로그인이 배포 주소에서만 튕긴다

• 증상: 내 컴퓨터에선 로그인되는데, 배포 주소에서는 로그인 후 오류 화면으로 간다.
• 원인: 로그인 서비스의 "허용된 주소" 목록에 localhost만 있다.
• 확인: 로그인 서비스 설정에 배포 주소를 추가한다.

6. 기본 주소는 되는데 내 도메인은 안 열린다

• 증상: 호스팅이 준 긴 주소는 열리는데, 산 도메인은 안 열린다.
• 원인: 도메인의 DNS 설정이 비었거나, 바뀐 설정이 퍼지는 중이다.
• 확인: 도메인을 산 곳의 DNS 화면에서 호스팅이 알려 준 값과 한 글자씩 대조한다. builder.zeroone.it.kr은 Cloudflare Pages에 CNAME 한 줄로 붙였다.

7. 컴퓨터에선 멀쩡한데 휴대폰에서 깨진다

• 증상: 휴대폰에서 좌우로 밀리고, 버튼이 잘 안 눌린다.
• 원인: 넓은 화면 기준으로만 확인했다.
• 확인: 실제 휴대폰으로 처음부터 끝까지 눌러 본다. 우리도 태블릿 폭에서 버튼 4개가 기준보다 8px 작았다.

어디서 멈췄는지 알면 질문이 달라진다

"배포가 안 돼요"라고 물으면 AI는 7곳을 전부 설명합니다.

"내 컴퓨터에선 되는데 배포본에서 환경변수 SUPABASE_URL을 못 읽어요"라고 물으면 4번만 답합니다. 한 번에 끝날 확률이 올라갑니다.