Azure K8s集群中Helm部署的MongoDB副本集客户端连接异常

从你提供的日志和配置来看，核心报错是MongoSocketOpenException: Exception opening socket，说明应用无法和skeleton-mongodb-replicaset-client:27001建立有效连接，或是后续无法访问副本集节点。下面是针对性的排查和解决步骤：

1. 先确认客户端服务的端口配置是否正确 #

首先排查你用的端口27001是否和Helm Chart实际配置一致：

• 执行命令查看服务详情：

  kubectl describe service skeleton-mongodb-replicaset-client
  

• 在输出的Spec.Ports部分，核对Port（服务对外端口）和TargetPort（容器内端口）：
  MongoDB默认容器端口是27017，如果没有特殊配置，Helm生成的客户端服务端口通常也是27017，而非27001。如果端口不匹配，修改连接URL中的端口为正确值后再测试。

2. 修复副本集节点的地址解析问题 #

即使成功连上客户端服务，MongoDB驱动会从副本集获取实际节点的地址列表（比如skeleton-mongodb-replicaset-0:27017这类Pod主机名），然后直接连接这些节点，而非继续通过客户端服务。如果应用Pod无法解析这些主机名，就会出现后续连接失败。

可以这样验证和修复：

• 先确认headless服务（负责解析Pod主机名）是否存在：

  kubectl get services | grep skeleton-mongodb-replicaset
  

  你应该能看到一个无ClusterIP的headless服务，它是Pod主机名解析的关键。
• 如果headless服务存在，在应用Pod内部测试解析节点主机名：

  kubectl exec -it <你的应用Pod名称> -- nslookup skeleton-mongodb-replicaset-0
  

  如果解析失败，检查集群DNS配置是否正常，或是确认应用Pod和MongoDB Pod在同一个namespace下。

3. 调整Helm Chart的副本集节点地址配置 #

如果上述步骤都没问题，可能是副本集节点向驱动返回的地址无法被应用访问。你可以修改Helm values配置，让节点使用完整的可访问域名：

• 编辑你的values文件，添加或修改以下配置：

  replicaSet:
    name: rs0
    hostnames:
      - skeleton-mongodb-replicaset-0.skeleton-mongodb-replicaset
      - skeleton-mongodb-replicaset-1.skeleton-mongodb-replicaset
      - skeleton-mongodb-replicaset-2.skeleton-mongodb-replicaset
  

• 执行Helm升级生效：

  helm upgrade skeleton stable/mongodb-replicaset -f your-values.yaml
  

  这样副本集节点会向驱动返回完整的集群内可访问域名，确保应用能正确解析连接。

4. 验证驱动与MongoDB版本兼容性 #

你使用的org.mongodb:mongodb-driver-async 3.6.4和MongoDB 4.0是兼容的，但建议升级到3.6.10及以上版本（修复了部分4.0兼容性问题），如果条件允许，升级到3.12.x版本（兼容MongoDB 3.4-4.4）会更稳定。

快速测试连接的小技巧 #

你可以在集群内启动临时MongoDB客户端Pod，验证连接链路是否正常：

kubectl run -it --rm mongo-client --image=mongo:4.0 --command -- mongo "mongodb://myuser:mydbpwd@skeleton-mongodb-replicaset-client:27017/skeleton?authSource=admin&replicaSet=rs0"

如果这个临时客户端能成功连接，说明问题出在你的应用Pod配置（比如网络策略、DNS、环境变量等）；如果也连接失败，就需要聚焦MongoDB服务或Helm配置的问题。

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