K8s中MongoDB StatefulSet应使用Pod还是Headless Service构造连接URI？

两种连接方式的合法性说明 #

两种都是合规的连接方式，核心差异是给MongoDB驱动提供种子节点的形式不同：

• 固定Pod FQDN方式：官方给出的是种子节点示例，本质是手动给驱动提供初始的副本集节点入口，只要有至少一个种子节点存活，MongoDB驱动会自动拉取全量副本集节点列表，扩容时无需修改URI，你之前理解的扩容要改URI是误解
• Headless Service方式：本质是通过K8s的DNS解析自动获取所有存活的MongoDB Pod IP作为种子节点，灵活性更高，不需要手动维护种子节点列表

你遇到的问题排查方案 #

部分副本宕机时连接丢失崩溃 #

你已经配置了replicaSet参数，仍出现该问题的常见遗漏配置点：

1. URI缺少必要的高可用参数，必须补充以下参数：
   retryWrites=true&serverSelectionTimeoutMS=5000&connectTimeoutMS=3000&retryReads=true
   参数作用是让驱动自动重试读写、设置合理的节点选择超时时间，避免单次节点访问失败就直接抛出连接异常
2. 应用端MongoDB驱动版本过旧，旧版本驱动对副本集故障转移的自动适配支持不完善，建议升级到对应语言的最新稳定版驱动
3. 应用侧使用短连接而非连接池，长连接池会在节点故障后自动与新的主节点重建连接，短连接每次新建连接时如果刚好解析到故障节点IP才会报错

跨Namespace无法连接Headless Service #

按顺序排查：

1. 先验证DNS解析正常：在其他Namespace的Pod内执行nslookup mongodb-headless.目标命名空间.svc.cluster.local，如果无法解析，检查集群CoreDNS是否运行正常
2. 验证网络连通性：在其他Namespace的Pod内执行nc -zv mongodb-headless.目标命名空间.svc.cluster.local 27017，如果端口不通，检查：
   • MongoDB容器是否绑定0.0.0.0，而非仅绑定127.0.0.1
   • 目标Namespace是否配置了网络策略，禁止其他Namespace访问27017端口
   • 节点之间的网络是否放行27017端口通信

最佳实践建议 #

优先使用Headless Service的连接方式，无需维护固定的种子节点列表，扩容缩容都不需要修改连接配置，只要确保上述提到的URI参数、驱动版本、网络配置正确，即可实现故障自动转移，不会出现部分副本宕机就连接崩溃的问题。

内容的提问来源于stack exchange，提问作者mr.Gray