DNS_PROBE_FINISHED_NXDOMAIN은 왜 발생하나요?

도메인에 대한 DNS 레코드가 없거나 오타가 있어 브라우저가 해당 호스트를 찾지 못할 때 발생합니다.

가장 먼저 무엇을 확인해야 하나요?

도메인 오탈자 여부와 DNS 콘솔의 A/CNAME 레코드 존재 여부를 먼저 확인하고, 공용 DNS에서 dig 조회로 반영 상태를 검증합니다.

Choorai | 문서

KO EN

도메인/배포 초기 자주 발생

DNS NXDOMAIN 에러 해결하기

브라우저에 DNS_PROBE_FINISHED_NXDOMAIN이 뜨나요? 도메인 레코드가 누락됐거나 아직 전파되지 않았을 가능성이 큽니다.

TL;DR (핵심 요약)

1) 도메인 오타 확인 2) DNS 콘솔에서 A/CNAME 레코드 확인 3) dig로 공용 DNS 반영 상태 확인 4) TTL 시간 동안 대기 후 재확인

심각

DNS_PROBE_FINISHED_NXDOMAIN

원인

요청한 도메인을 DNS에서 찾을 수 없습니다. 주로 레코드 누락, 도메인 오타, 잘못된 nameserver 설정으로 발생합니다.

해결책

도메인 철자와 서브도메인(host) 재확인
DNS 공급자에서 A/CNAME 레코드 생성 여부 확인
등록기관의 nameserver가 올바른 DNS 제공자를 가리키는지 확인
전파 시간이 필요한 경우 TTL 만큼 대기

점검 순서

1) 도메인 조회 테스트

terminal

# 권한 DNS/공용 DNS 조회

dig your-domain.com

dig @1.1.1.1 your-domain.com

dig @8.8.8.8 your-domain.com

2) Cloudflare 레코드 예시

DNS records

Type    Name    Content             Proxy
A       @       203.0.113.10        DNS only
CNAME   www     your-domain.com      Proxied

주의

같은 호스트에 A와 CNAME을 동시에 중복 구성하면 예상치 못한 해석 오류가 날 수 있습니다.

3) nameserver 확인

등록기관(가비아, 후이즈 등)에서 설정한 nameserver가 DNS 제공자 값과 일치해야 합니다. nameserver가 다른 서비스로 향하면 DNS 레코드를 올바르게 만들어도 반영되지 않습니다.

Prerequisites

도메인/서브도메인 이름과 목표 IP 또는 CNAME 값을 알고 있어야 합니다.
DNS 제공자(Cloudflare/Route53 등) 콘솔 접근 권한이 있어야 합니다.
터미널에서 dig 또는 nslookup 명령을 실행할 수 있어야 합니다.

Validation

권한 있는 DNS 서버에서 A/AAAA/CNAME 레코드가 조회됩니다.
공용 DNS(8.8.8.8, 1.1.1.1)에서도 동일한 결과가 조회됩니다.
브라우저에서 NXDOMAIN 대신 실제 서비스 응답이 확인됩니다.

Troubleshooting

오탈자(`api.example.com` vs `api.exmaple.com`)를 먼저 확인하세요.
루트/서브도메인에 A와 CNAME을 동시에 잘못 구성하지 않았는지 확인하세요.
TTL 캐시를 고려해 DNS 반영 시간을 충분히 기다린 뒤 재조회하세요.

References

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기