MongoDB Atlas 연결 오류: queryTxt ETIMEOUT 문제 해결 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

• *Node.js 개발자 및 MongoDB 사용자**

- 난이도: 초급~중급

- 관련 분야: 네트워크 설정, DNS 문제 해결, MongoDB 연결 구성

핵심 요약

• queryTxt ETIMEOUT 오류는 DNS TXT 레코드 조회 실패로 인한 네트워크 문제
• MongoDB SRV 연결 문자열(mongodb+srv://)은 SRV 및 TXT 레코드 조회가 필수
• ISP DNS 서버 문제 해결: Google DNS(8.8.8.8, 8.8.4.4) 또는 Cloudflare DNS(1.1.1.1) 사용 권장

섹션별 세부 요약

1. 오류 발생 상황

• queryTxt ETIMEOUT 오류는 MongoDB Atlas의 SRV 연결 문자열에서 DNS TXT 레코드 조회 실패로 인해 발생
• 코드 수정, MongoDB 서버 문제, 로컬 MongoDB 테스트 모두 실패
• 기존 ISP DNS 서버가 TXT 레코드를 제대로 처리하지 못하는 것으로 확인

2. 문제 진단 과정

• DNS 문제 확인: nslookup 및 dig 명령어로 TXT/SRV 레코드 조회 실패
• ISP 변경 후 문제가 해결되었음 (휴대폰 핫스팟 사용 시 정상 연결)
• ISP DNS 서버가 MongoDB SRV 연결에 필요한 TXT 레코드를 제대로 처리하지 못함

3. 해결 방법

• ISP DNS 서버 대신 Google DNS(8.8.8.8, 8.8.4.4) 또는 Cloudflare DNS(1.1.1.1) 사용

- Windows: 네트워크 설정에서 DNS 서버 주소 변경

- macOS/Linux: /etc/resolv.conf 또는 네트워크 관리자 설정

• SRV 연결 문자열 대신 일반 MongoDB 연결 문자열(mongodb://) 사용 (TXT 레코드 요구사항 우회)

4. 추가 고려사항

• ISP DNS 제한: 일부 ISP는 TXT 레코드 조회를 차단하거나 지연
• 기업 네트워크: 회사 방화벽이 DNS 레코드 유형을 제한할 수 있음
• 지역별 DNS 문제: 특정 DNS 서버가 특정 레코드 유형을 제대로 프록시하지 못함

결론

• queryTxt ETIMEOUT 오류는 코드 또는 MongoDB 문제보다 네트워크/DNS 설정에 초점 맞추어야 함
• ISP DNS 서버 대신 공개 DNS 서버(예: Google 8.8.8.8) 사용이 가장 신뢰성 있는 해결책
• DNS 문제 진단: nslookup -type=TXT 또는 dig TXT 명령어로 TXT 레코드 조회 실패 여부 확인