本地Node.js连接启用公网访问和私有链接的Cosmos DB失败求助

1. 检查Cosmos DB公网访问防火墙规则 #

• 确认新建实例的公网访问IP白名单是否包含你的Mac公网IP。即使启用私有链接，公网访问的IP限制依然生效，若未添加当前IP，会导致连接被拒绝后断开。
• 可临时将公网访问设置为“允许所有网络”测试，若能正常连接，说明是IP白名单问题，将Mac公网IP加入规则即可。

2. 验证Node.js MongoDB驱动版本兼容性 #

• 同时启用私有链接的Cosmos DB实例对Mongo驱动版本要求更严格，检查当前mongodb包版本是否符合Azure兼容要求（需3.6+版本，旧版本可能在混合模式下出现连接异常）。
• 执行npm list mongodb查看版本，尝试升级到稳定兼容版本（如4.x或5.x）后重新测试。

3. 核对连接字符串配置细节 #

• 确认连接字符串包含正确端口（MongoAPI默认10255），且添加了ssl=true参数。启用私有链接的实例强制要求SSL连接，遗漏该参数会导致连接异常断开。
• 示例正确格式：mongodb://<username>:<password>@testcosmosdb.mongo.cosmos.azure.com:10255/?ssl=true&replicaSet=globaldb&retrywrites=false&maxIdleTimeMS=120000&appName=@testcosmosdb@

4. 排查Mac本地网络限制 #

• 检查Mac系统防火墙（系统偏好设置-安全与隐私-防火墙）是否阻止Node.js应用出站连接10255端口。临时关闭防火墙测试，若恢复正常，需添加应用出站规则。
• 用nc -zv testcosmosdb.mongo.cosmos.azure.com 10255测试端口连通性，若连接被拒绝，说明本地网络或Cosmos端防火墙拦截了流量。

5. 检查私有链接配置对公网访问的影响 #

• 确认新建实例的私有链接未误限制公网访问权限，即使界面显示启用公网访问，也需检查networkAcls设置。
• 通过Azure CLI查看配置：az cosmosdb show --name testcosmosdb --resource-group <你的资源组名> --query "networkAcls"，确保defaultAction为Allow且无额外拒绝规则。

6. 刷新Mac DNS缓存 #

• 虽然nslookup解析正常，但Mac可能存在DNS缓存异常，尝试刷新缓存：
  • macOS Ventura及以上：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
  • 旧版本macOS：sudo killall -HUP mDNSResponder
• 之后重新测试连接，或直接用解析出的IP替换域名在连接字符串中测试。

内容的提问来源于stack exchange，提问作者Coder