GKE部署的NodeJS应用连MongoDB Atlas失败，如何测试集群连接？

1. 在GKE Pod内直接做网络连通性测试 #

先创建一个带网络工具的临时Pod，模拟应用的网络环境：

kubectl run -it --rm test-pod --image=busybox:1.36 --restart=Never

进入Pod后，优先测试MongoDB Atlas节点的私有IP（VPC对等场景必须用私有地址，不能用公网地址）：

• 测试ICMP连通性（部分环境可能禁用ICMP，端口测试更关键）：

  ping <mongodb-atlas-private-ip>
  

• 测试MongoDB默认端口27017的连通性：

  nc -zv <mongodb-atlas-private-ip> 27017
  # 或者用telnet
  telnet <mongodb-atlas-private-ip> 27017
  

如果端口测试失败，说明VPC对等的路由、防火墙存在问题；如果端口能连通，再排查应用层的连接配置。

2. 用MongoDB客户端模拟应用连接 #

创建带MongoDB客户端的测试Pod，直接复现应用的连接逻辑：

kubectl run -it --rm mongo-test --image=ubuntu:22.04 --restart=Never

进入Pod后安装客户端：

apt update && apt install -y mongodb-clients

使用Atlas的私有连接字符串发起连接（替换为你的实际配置）：

# 用SRV格式的私有连接字符串
mongosh "mongodb+srv://<用户名>:<密码>@<集群私有域名>.mongodb.net/"
# 或者用直接指定私有IP的连接字符串（适用于副本集）
mongosh mongodb://<用户名>:<密码>@<私有IP1>:27017,<私有IP2>:27017/<数据库名>?replicaSet=<副本集名称>

这里会返回具体的连接错误（如认证失败、副本集无法解析等），能精准定位问题。

3. 检查GKE集群侧的网络配置 #

• 确认GKE集群所在VPC与Atlas对等的VPC一致：

  gcloud container clusters describe <集群名称> --zone <可用区> | grep -A 5 "network"
  

• 检查节点子网的出站防火墙规则，确保允许访问Atlas私有IP段的27017端口：

  gcloud compute firewall-rules list --filter="network:<VPC名称> AND direction:EGRESS"
  

• 验证节点路由表是否包含指向Atlas对等IP段的路由条目：

  gcloud compute routes list --filter="network:<VPC名称>"
  

4. 验证MongoDB Atlas侧的配置 #

• 确认VPC对等连接已正确关联GKE集群的VPC，且Atlas集群已启用私有端点，仅允许对等VPC的流量访问。
• 查看Atlas的连接日志，检查是否有来自GKE节点IP的连接尝试，以及具体的拒绝原因（如IP不在白名单、认证错误等）。

关键排查要点 #

• 必须确保应用使用私有连接字符串，公网连接字符串在VPC对等场景下会被拒绝。
• 如果Atlas同时配置了IP白名单和VPC对等，需要将GKE节点的IP段加入白名单，或者设置Atlas仅允许对等VPC的流量。
• 确认VPC对等连接的路由传播已启用，双方的路由表都能正确识别对方的IP段。

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