? 문제 상황
sv-practice.johnnyji.dev 서브도메인으로 접속이 되지 않는 문제가 발생했다.
Vercel 대시보드에서는 Valid Configuration으로 표시되고 있었지만 실제 브라우저에서 접속하면 오류 페이지가 나타났다.
? 구성 환경
서비스 역할 설정 항목
Cloudflare DNS 관리 CNAME 레코드 (sv-practice → Vercel)
Vercel 배포 플랫폼 커스텀 도메인 연결
GitHub 소스 저장소 About 웹사이트 URL
? 원인 분석
원인은 서브도메인 이름 변경 시 완전히 삭제하지 않고 DNS 이름만 수정한 것이었다.
- 원래 Vercel에 sv.johnnyji.dev로 연결되어 있었고, Cloudflare에도 sv CNAME 레코드가 존재했다.
- 목표 URL을 sv-practice.johnnyji.dev로 변경하면서 Cloudflare CNAME 이름만 sv-practice로 수정했다.
- Vercel이 도메인 검증 시 캐시해둔 정보와 실제 DNS가 맞지 않아 TLS 인증서 발급이 꼬이면서 접속 오류가 발생했다.
핵심 원인: Vercel에 도메인을 등록한 채로 Cloudflare DNS의 이름만 수정하면, Vercel의 TLS 인증서 발급 및 라우팅이 꼬일 수 있다.
✅ 해결 방법 — 완전 삭제 후 재등록
Step 1. Vercel에서 기존 도메인 제거
Vercel 프로젝트 → Settings → Domains에서 해당 도메인을 Remove한다.
Step 2. Cloudflare에서 기존 CNAME 삭제
Cloudflare DNS 레코드에서 기존 CNAME을 완전히 Delete한다.
Step 3. Vercel에 도메인 새로 추가
Vercel → Add Existing에서 sv-practice.johnnyji.dev를 입력하고 Save한다. Vercel이 요구하는 새로운 CNAME 값을 확인한다.
Step 4. Cloudflare에 새 CNAME 레코드 추가
Type Name Target Proxy
CNAME sv-practice c5d261e0bb9917b1.vercel-dns-017.com ❌ DNS only (반드시 OFF)
⚠️ 핵심: Cloudflare Proxy(주황 구름)를 반드시 **DNS only(OFF)**로 설정해야 한다. Proxy ON 상태에서는 Vercel이 SSL 인증서를 발급할 수 없다.
Step 5. GitHub 저장소 About URL 업데이트
GitHub 저장소 → About 톱니바퀴 → Website 항목을 https://sv-practice.johnnyji.dev로 업데이트한다.
? 최종 설정 상태
서비스 항목 설정값 상태
Cloudflare CNAME sv-practice c5d261e0bb9917b1.vercel-dns-017.com ✅ DNS only
Vercel sv-practice.johnnyji.dev Production 연결 ✅ Valid Configuration
GitHub About Website URL https://sv-practice.johnnyji.dev ✅ 완료
? 교훈
- 도메인 변경 시에는 반드시 Vercel과 DNS 양쪽을 동시에 삭제 후 재등록하는 것이 가장 안전하다.
- Cloudflare Proxy는 Vercel과 함께 사용할 때 항상 DNS only로 설정해야 한다.
- Vercel에서 Valid Configuration이 표시되더라도 실제 접속이 안 될 수 있으니, DNS가 완전히 삭제 후 재등록됐는지 확인해야 한다.
- DNS 변경 후에는 **전파 시간(수 분 ~ 최대 1시간)**이 필요하다.