가장 먼저 볼 곳

www는 열리는데 루트 도메인(example.com)만 Vercel 404라면, 보통 원인은 둘 중 하나입니다.

1. example.com이 Vercel 프로젝트에 제대로 연결되지 않았거나
2. 루트 도메인 DNS가 다른 곳을 보고 있음

Vercel 404는 대개 앱 코드 문제보다 도메인 연결 문제일 가능성이 더 큽니다.

확인 순서

1) Vercel 프로젝트에 루트 도메인이 직접 추가돼 있는지 Vercel에서 www.example.com만 등록돼 있고 example.com이 빠져 있으면, www만 정상이고 루트는 404가 날 수 있습니다.

확인할 것:

• Vercel > Project > Settings > Domains
• example.com
• www.example.com

이 둘이 둘 다 등록되어 있어야 합니다.

2) Cloudflare DNS에서 루트 도메인 레코드 확인 루트 도메인은 보통 다음 형태 중 하나로 Vercel을 가리켜야 합니다.

• A 레코드 → 76.76.21.21
• 또는 Vercel이 안내한 apex 연결 방식

www는 보통 CNAME으로 연결되고, 루트는 A 또는 CNAME flattening 형태라서 설정이 다를 수 있습니다.

특히 확인할 것:

• @ 레코드가 Vercel 값으로 되어 있는지
• 예전 호스팅 IP가 남아 있지 않은지
• 중복 레코드가 없는지

3) Cloudflare 프록시 상태 잠깐 확인 Cloudflare에서 오렌지 구름(Proxy)이 켜져 있으면 캐시나 프록시 영향으로 헷갈릴 수 있습니다.

문제 확인 단계에서는 루트 도메인 DNS를 잠시 DNS only로 바꿔서 테스트해보면 원인 분리가 쉽습니다.

4) Vercel에서 Primary Domain / Redirect 설정 확인 가끔 www를 기본 도메인으로 잡아놓고 루트 도메인 리다이렉트가 안 걸려 있으면, 루트 접근 시 기대한 동작이 안 나옵니다.

확인할 것:

• www를 대표 도메인으로 쓸지
• 루트(example.com)를 www로 301 리다이렉트할지
• 반대로 루트를 대표로 쓸지

둘 중 하나로 정책을 명확히 잡아야 합니다.

빠르게 진단하는 방법

경우 1: 루트 도메인이 Vercel Domains에 없음 가장 흔한 원인입니다. - 해결: example.com을 프로젝트에 추가

경우 2: 루트 DNS가 예전 서버를 가리킴 - 해결: Cloudflare의 @ 레코드를 Vercel 기준으로 수정

경우 3: 다른 Vercel 프로젝트에 붙어 있음 같은 계정이나 다른 팀의 다른 프로젝트에 그 도메인이 먼저 연결돼 있으면 이상하게 404가 날 수 있습니다. - 해결: 해당 도메인이 어느 프로젝트에 연결돼 있는지 확인

경우 4: 인증/전파가 아직 안 끝남 - 해결: DNS 전파와 Vercel domain verification 상태 확인

추천 체크리스트

• Vercel Domains에 example.com이 있는가
• Vercel Domains에 www.example.com이 있는가
• Cloudflare @ 레코드가 Vercel을 가리키는가
• Cloudflare에 중복 A/CNAME이 없는가
• 루트와 www 중 어느 쪽이 대표 도메인인지 정했는가
• 리다이렉트 정책이 설정돼 있는가

한 줄로 정리

이 경우는 거의 항상 루트 도메인 자체가 Vercel 프로젝트에 안 붙어 있거나, Cloudflare의 @ DNS가 잘못된 것부터 보면 됩니다.