이 페이지의 섹션에는 MongoDB Compass를 연결할 때 표시되는 일반적인 오류가 나열되어 있으며 가능한 해결책을 제공합니다.
제공된 호스트 및 포트에서 MongoDB가 실행되지 않음
Compass가 지정된 호스트 및 포트에서 데이터베이스에 연결을 시도할 때 연결이 실패했습니다.
가능한 원인
이 오류는 주로 다음과 같은 경우에 발생합니다:
Compass 연결 대화 상자에 호스트 이름을 입력하지 않거나 잘못된 호스트 이름을 입력합니다.
대상 서버가 잘못된 포트에서 연결을 거부합니다.
MongoDB 클러스터 또는 서버가 종료되었거나 서버의 호스트 이름이 변경되었습니다.
로컬 네트워크와의 연결을 적극적으로 차단하는 방화벽이 있습니다.
솔루션
이 문제에 대한 해결책은 MongoDB 환경이 구성된 방식에 따라 달라질 수 있습니다. MongoDB 환경에 적합한 탭을 선택하여 가능한 해결책을 확인합니다.
자체 호스팅 MongoDB 서버, 복제본 세트 또는 클러스터가 있는 경우 다음 해결책을 시도해 보세요.
MongoDB 인스턴스가 실행 중인지 확인합니다
Compass must connect to a running MongoDB instance. Make sure you have installed MongoDB and have a running mongod process. You should also check that the port where your MongoDB instance is running matches the port you provide in the Compass connect dialog.
필수 구성 파일 설정: bindIp
If you recently installed the MongoDB database server and are unable to establish an initial connection to that server, verify that you have specified a valid net.bindIp setting in your server configuration file.
호스트 이름 및 포트
If your self-hosted server is listening on an external network via net.bindIp, verify that you have specified your Hostname and Port correctly in the Compass connect dialog.
MongoDB 서버 이동 또는 종료
MongoDB 클러스터 또는 서버가 종료되었거나 호스트 이름이 변경되었을 수 있습니다. 데이터베이스의 상태에 대한 업데이트는 데이터베이스 관리자에게 문의하세요.
방화벽
If you believe your firewall may be actively blocking connections to the port(s) your database(s) are operating on, try connecting from a different location, such as a home or internet cafe network. You can also visit http://portquiz.net/ to test your connection to different ports.
If you are connecting to an Atlas cluster, first follow the procedure described in the Connect via Compass page in the Atlas documentation. The steps on that page will help ensure that your connection settings are optimized for Atlas.
MongoDB 서버 이동 또는 종료
MongoDB 클러스터 또는 서버가 종료되었거나 호스트 이름이 변경되었을 수 있습니다. 데이터베이스의 상태에 대한 업데이트는 데이터베이스 관리자에게 문의하세요.
방화벽
방화벽이 데이터베이스에 대한 연결을 적극적으로 차단하고 있다고 생각되면 집이나 인터넷 카페 네트워크와 같은 다른 위치에서 연결을 시도해보세요.
Atlas clusters operate on port 27017. You must be able to access this port to access your cluster. To check if your local network blocks connections to port 27017, visit http://portquiz.net:27017/.
Atlas IP 액세스 목록에 사용자 주소가 포함되어 있지 않음
Atlas only allows connections to a cluster from addresses listed in the project IP access list. Ensure that you have access listed your IP address so you can connect to your cluster.
지능형 어시스턴트 를 사용하여 MongoDB Compass에서 연결 오류 디버깅을 지원할 수 있습니다.
문서 삽입 단추가 비활성화되어 문서를 수정할 수 없습니다.
Compass를 사용하는 경우 쓰기 작업을 수행할 수 없고 데이터 읽기만 가능한 상태가 될 수 있습니다.
가능한 관찰 사항
이 상태인 경우:
Create Collection 및 Insert Document 버튼이 비활성화됩니다.
문서를 수정할 수 없습니다.
가능한 원인
이러한 행동의 원인은 두 가지가 있을 수 있습니다:
쓰기 작업을 지원하지 않는 클러스터의 세컨더리 멤버에 연결되어 있습니다.
쓰기 작업을 지원하지 않는 Compass Readonly 버전을 사용하고 있습니다.
솔루션
읽기 환경 설정 확인
Compass 연결 대화 상자에서 Read Preference를 Primary로 설정합니다. 이렇게 하면 쓰기 작업을 지원하는 클러스터의 프라이머리 멤버에 연결할 수 있습니다.
복제본 세트 이름 확인
Replica Set Name이 정확한지 확인합니다. Compass는 복제본 세트 이름이 정확한 경우에만 프라이머리를 올바르게 식별할 수 있습니다.
만약 클러스터가 Atlas에서 호스팅되는 경우 다음 절차를 사용하여 올바른 복제본 세트 이름을 얻을 수 있습니다.
Atlas Clusters 뷰로 이동합니다.
원하는 클러스터의 Connect 을 클릭합니다.
Connect with MongoDB Compass를 클릭합니다.
제공된 연결 문자열을 복사하세요.
MongoDB Compass를 엽니다.
연결 설정을 자동으로 채우려면 Yes를 클릭합니다.
Compass 에디션 확인
Compass Readonly 에디션에서는 쓰기 작업을 수행할 수 없습니다. 최상위 Compass 드롭다운 메뉴를 열고 About MongoDB Compass를 선택하여 Compass 에디션을 확인할 수 있습니다.
쓰기 작업을 수행하려면 MongoDB Compass의 다른 에디션을 다운로드해야 합니다. Compass 에디션 간의 차이점에 대한 자세한 내용은 Compass 에디션의 기능을 참조하세요.
클러스터 샤드에 대한 연결 종료
이 오류는 초기 설정이 완료되기 전에 MongoDB 클러스터에 대한 연결이 닫혔음을 의미합니다.
가능한 관찰 사항
MongoDB Compass에서 다음과 유사한 오류가 표시될 수 있습니다:
connection 3 to cluster0-shard-00-00-a1b2c.mongodb.net:27017 closed
가능한 원인
The most common source of this error is a missing Atlas IP access list entry for the public IP address where Compass is running.
솔루션
Compass가 실행 중인 공용 IP 주소가 Atlas 프로젝트의 IP 액세스 목록에 포함되어 있는지 확인하세요.
Atlas 액세스 목록을 구성하려면:
Atlas의 왼쪽 상단에 있는 Context 드롭다운을 사용하여 원하는 Atlas 프로젝트를 선택합니다.
Security 탭을 클릭합니다.
IP Access List 메뉴 옵션을 클릭합니다.
IP 주소가 액세스 목록에 없으면 Add IP Address를 클릭하세요.
Add Current IP Address를 클릭합니다.
Confirm를 클릭합니다.
Atlas는 액세스 목록에서 현재 IP 주소를 포함하는 항목을 인식하고 이러한 주소에 (includes your current IP address)를 추가합니다.
팁
For more information on configuring access list entries, see Configure Access List Entries in the Atlas documentation.
프라이머리 또는 세컨더리가 아닌 경우 쓰기 불가
이 오류 메시지는 올바른 복제본 세트 이름을 제공하지 않고 복제본 세트의 세컨더리 멤버 중 하나에 연결했으며 동시에 Read Preference의 프라이머리 멤버에 연결해야 함을 나타냅니다.
솔루션
Atlas 복제본 세트 이름 확인
Compass 연결 대화 상자에 올바른 복제본 세트 이름을 제공하고 있는지 확인해야 합니다.
만약 클러스터가 Atlas에서 호스팅되는 경우 다음 절차를 사용하여 올바른 복제본 세트 이름을 얻을 수 있습니다.
Atlas Clusters 뷰로 이동합니다.
원하는 클러스터의 Connect 을 클릭합니다.
Connect with MongoDB Compass를 클릭합니다.
제공된 연결 문자열을 복사하세요.
MongoDB Compass를 엽니다.
연결 설정을 자동으로 채우려면 Yes를 클릭합니다.
Compass가 세컨더리에 연결하도록 허용하기
이 오류를 해결하는 또 다른 방법은 Compass가 세컨더리 클러스터 멤버에 연결하도록 허용하는 것입니다. 연결 설정에서 Read Preference를 Primary Preferred 또는 Secondary Preferred로 변경하세요. 이렇게 하면 이 오류를 우회하여 연결할 수 있습니다.
참고
세컨더리 멤버에 연결하면 문서, 인덱스 또는 데이터베이스를 생성하거나 수정할 수 없습니다. 쓰기 작업을 수행할 필요가 없는 경우에만 이 솔루션을 사용하십시오.
팁
For more information on read preferences, see Read Preference in the MongoDB manual.
인증 실패
Compass를 사용하여 클러스터에 연결하려고 할 때 Authentication Failed라는 오류 메시지가 표시될 수 있습니다.
가능한 원인
이 오류 메시지는 대개 5가지 조건 중 하나로 인해 발생하는 경우가 많습니다:
복사된 연결 문자열에서 연결 세부정보를 자동 완성한 후 Password가 누락되었습니다. Compass에서는 보안 예방 조치로 연결 대화 상자에 비밀번호의 수동 입력을 요구합니다.
Username 및/또는 Password가 올바르지 않습니다.
You have not configured any MongoDB users for your Atlas cluster.
올바른 Authentication 메서드를 선택하지 않았습니다.
You did not specify the correct Authentication Database. This setting corresponds to the authSource connection string option.
참고
Atlas 클러스터의 경우 Authentication Database은 일반적으로
admin입니다.
솔루션
올바른 Username 및 Password를 입력했는지 확인합니다.
인증하려는 MongoDB 사용자가 존재하는지 확인합니다.
Authentication Database 및 인증 메커니즘을 확인합니다.
선택한 인증 메커니즘이 MongoDB database에서 지원되는지 확인하세요.
Compass 로그 확인
Compass 로그는 연결 오류에 대한 추가 정보를 제공할 수 있습니다. 문제를 진단하는 데 도움이 되는 자세한 오류 메시지를 확인할 수 있습니다. 자세한 내용은 Compass 로그 조회를 참조하세요.