Compass Connection ErrorsCompass连接错误

Likely Causes可能的原因

This error often occurs when:此错误通常发生在以下情况：

• You provide no hostname or an invalid hostname to the Compass connect dialog.您没有向“Compass连接”对话框提供主机名或主机名无效。
• The destination server rejects a connection on an incorrect port.目标服务器拒绝不正确端口上的连接。
• Your MongoDB cluster or server has been shutdown or the server hostname has changed.您的MongoDB集群或服务器已关闭，或者服务器主机名已更改。
• You have a firewall actively blocking connections to/from your local network.您有一个防火墙正在主动阻止与本地网络的连接。

Solutions解决方案

The solution to this issue may depend on how your MongoDB environment is configured. 这个问题的解决方案可能取决于如何配置MongoDB环境。Select the appropriate tab for your MongoDB environment to view possible solutions:为您的MongoDB环境选择适当的选项卡以查看可能的解决方案：

Possible Observations可能的观察结果

When you are in this state:当您处于这种状态时：

• The Create Collection and Insert Document buttons are disabled.“创建集合”和“插入文档”按钮处于禁用状态。
• You cannot modify any of your documents.您不能修改任何文档。

Likely Cause可能的原因

There are two likely causes for this behavior:这种行为可能有两个原因：

• You are connected to a secondary member of your cluster, which does not support write operations.您已连接到群集的辅助成员，该成员不支持写入操作。
• You are using Compass Readonly edition, which does not support write operations.您使用的是“Compass只读”版本，该版本不支持写入操作。

Solutions解决方案

Possible Observations可能的观察结果

You may see an error in MongoDB Compass similar to the following:您可能会在MongoDB Compass中看到类似以下的错误：

connection 3 to cluster0-shard-00-00-a1b2c.mongodb.net:27017 closed

Likely Cause可能的原因

The most common source of this error is a missing Atlas IP whitelist entry for the public IP address where Compass is running.此错误最常见的来源是Compass运行的公共IP地址缺少Atlas IP白名单条目。

Solution解决方案

Ensure the public IP address where Compass is running is included in your Atlas project's IP whitelist.确保Compass运行的公共IP地址包含在Atlas项目的IP白名单中。

To configure your Atlas whitelist:要配置Atlas白名单：

1. Use the Context dropdown in the top-left of Atlas to select your desired Atlas project.使用Atlas左上角的“上下文”下拉菜单选择您想要的Atlas项目。
2. Click the Security tab.单击“安全”选项卡。
3. Click the IP Whitelist menu option.单击“IP白名单”菜单选项。
4. If your IP address is not in the whitelist, click Add IP Address.如果您的IP地址不在白名单中，请单击“添加IP地址”。
5. Click Add Current IP Address.单击“添加当前IP地址”。
6. Click Confirm.单击“确认”。

Atlas recognizes which entries in the whitelist include your current IP address, and appends these addresses with (includes your current IP address).Atlas识别白名单中的哪些条目包括您当前的IP地址，并将这些地址附加为（包括您的当前IP地址）。

Solutions解决方案

Likely Causes可能的原因

This error message is often the result of one of five conditions:此错误消息通常是以下五种情况之一的结果：

• Your Password is missing after autofilling your connection details from a copied connection string. 从复制的连接字符串中自动填充连接详细信息后，您的“密码”丢失。Compass requires you to manually enter your password in the connection dialog as a security precaution.作为安全预防措施，Compass要求您在连接对话框中手动输入密码。
• Your Username and/or Password are incorrect.您的“用户名”和/或“密码”不正确。
• You have not configured any MongoDB users for your Atlas cluster.您尚未为Atlas集群配置任何MongoDB用户。
• You did not select the correct Authentication method.您没有选择正确的“身份验证”方法。
• You did not specify the correct Authentication Database. 您没有指定正确的“身份验证数据库”。This setting corresponds to the authSource connection string option.此设置对应于authSource连接字符串选项。
  Note

  For Atlas clusters, the Authentication Database is usually admin.对于Atlas集群，“身份验证数据库”通常是admin。

Solutions解决方案

• Ensure you provided the correct Username and Password.确保您提供了正确的“用户名”和“密码”。
• Ensure that the MongoDB user you are authenticating as exists.确保您正在验证的MongoDB用户存在。
• Verify your Authentication Database and authentication mechanism.验证“身份验证数据库”和身份验证机制。
• Verify that your selected authentication mechanism is supported by your MongoDB database.验证MongoDB数据库是否支持您选择的身份验证机制。