MongoDB Atlas 접속 오류 해결 – IP가 바뀌었을 때 대처법

MongoDB Atlas 접속 오류 해결 - 외부 IP 접속 차단 이슈

상황

로컬에서 MongoDB 연결이 정상 작동했으나,
카페에서 개발을 시도하자 다음과 같은 오류가 발생했습니다:

MongooseServerSelectionError: Could not connect to any servers in your MongoDB Atlas cluster. 
One common reason is that you're trying to access the database from an IP that isn't whitelisted. 
Make sure your current IP address is on your Atlas cluster's IP whitelist: 
https://docs.atlas.mongodb.com/security-whitelist/

---

원인

• MongoDB Atlas는 보안을 위해 허용된 IP에서만 접속이 가능하도록 설정되어 있음
• 집에서 등록한 IP로는 접속 가능했지만, 카페 등 다른 장소에서는 IP가 달라 접속 불가

---

해결 방법

1. MongoDB Atlas(https://cloud.mongodb.com)에 로그인
2. 좌측 메뉴 → Security > Network Access
3. IP Whitelist 목록에서 현재 접속 IP 추가
   • + ADD IP ADDRESS 버튼 클릭
   • CURRENT IP ADDRESS 선택 후 저장
4. 변경사항 적용 후, 다시 API 또는 애플리케이션 실행

---

팁

• 매번 IP가 바뀌는 환경이라면 0.0.0.0/0을 등록하여 모든 IP 허용도 가능 (보안상 권장 X)
• 가능하다면 VPN 또는 고정 IP 환경에서 개발 권장
• Atlas 프로젝트 설정은 IAM 권한이 있어야 수정 가능함

---

요약

항목	설명
문제	MongoDB Atlas에 외부 IP로 접속 불가
원인	IP Whitelist에 현재 접속 IP가 없음
해결 방법	Atlas 콘솔에서 현재 IP 추가
비고	보안을 위해 제한된 IP만 등록하는 것이 권장됨