排查 Azure Cosmos DB for MongoDB vCore 中的常见问题

适用对象: MongoDB vCore

本指南旨在帮助解决使用 Azure Cosmos DB for MongoDB vCore 时可能遇到的问题。 本指南提供连接问题、错误方案和优化难题的解决方案,并提供实用的见解来改善体验。

注意

请注意,这些解决方案是一般准则,可能需要根据个别情况进行特定配置。 请始终参考官方文档和支持资源,以获取最准确和最新的信息。

常见错误和解决方法

无法连接到 Azure Cosmos DB for MongoDB vCore - 超时错误

当群集未启用正确的防火墙规则时,可能会出现此问题。 如果尝试从非 Azure IP 范围访问群集,则需要添加额外的防火墙规则。 有关详细步骤,请参阅安全选项和功能 - Azure Cosmos DB for MongoDB vCore。 可以在门户的“网络”设置中为群集配置防火墙规则。 选项包括添加已知的 IP 地址/范围或启用公共 IP 访问。

Azure Cosmos DB for MongoDB vCore 超时错误解决方案的屏幕截图。

无法连接,出现 DNSClient.DnsResponseException 错误

调试连接问题:

Windows 用户:
Psping 不起作用。 nslookup 的使用确认了群集的可及性和可发现性,表明不太可能是网络问题。

Unix 用户:
对于套接字/网络相关的异常,潜在的网络连接问题可能会阻碍应用程序与 Azure Cosmos DB Mongo API 终结点建立连接。

若要检查连接,请执行以下步骤:

nc -v <accountName>.documents.azure.cn 10250

如果 TCP 连接到端口 10260 失败,则环境防火墙可能会阻止 Azure Cosmos DB 连接。 请向下滚动到页面底部以提交支持票证。

验证连接字符串:

仅使用 Azure 门户中提供的连接字符串。 确保它包括 mongodb+srv:// 协议,因为这是正确连接所需的。 避免使用任何变体或前缀,如 c.。 如果遇到连接问题,请提交支持工单,以便共享应用程序或客户端驱动程序日志以用于调试。

后续步骤

如果已完成所有故障排除步骤,但无法发现问题的解决方案,请考虑提交支持票证