Kubernetes部署的NodeJS服务无法连接MongoDB Atlas问题求助

核心排查与解决步骤 #

1. 确认Pod真实出口IP #

Atlas的IP白名单需要的是Pod对外访问的实际出口IP，而非节点公网IP。在Pod内执行命令获取真实出口IP：

kubectl exec -it <你的Pod名称> -- curl -s https://ifconfig.me

将得到的IP添加到MongoDB Atlas的网络白名单，测试连接是否恢复。

2. 验证MongoDB连接字符串 #

• 检查用户名、密码是否正确，若密码包含@、&等特殊字符，需做URL编码（例如@编码为%40）。
• 确认连接字符串中的集群地址、认证数据库（默认admin）配置无误。

3. 测试Pod内DNS解析 #

在Pod内执行域名解析测试，确认Atlas集群域名能正常解析：

kubectl exec -it <你的Pod名称> -- nslookup ac-tszcvnh-shard-00-00.efxgtyi.mongodb.net

若解析失败，可在Deployment的Pod spec中配置公共DNS：

spec:
  dnsPolicy: "None"
  dnsConfig:
    nameservers:
      - 8.8.8.8
      - 1.1.1.1

4. 检查节点防火墙与安全组 #

• 确认节点防火墙（如ufw）允许出站27017端口流量。
• 若节点是云服务器，检查云服务商安全组规则，放行出站到MongoDB Atlas IP段的27017端口。

5. 临时白名单验证 #

临时将0.0.0.0/0添加到Atlas网络白名单，若此时能连接，说明之前的出口IP判断错误，重新排查Pod真实出口IP。

6. 测试直接连接 #

若容器内已安装mongosh，在Pod内直接测试连接，获取更精准的错误信息：

kubectl exec -it <你的Pod名称> -- mongosh "mongodb+srv://<用户名>:<密码>@ac-tszcvnh.efxgtyi.mongodb.net/"

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