MongoDB单镜像副本集在GitLab CI/CD中出现ReplicaSetGhost超时问题

核心原因分析 #

1. 共享Runner的网络隔离限制 #

GitLab共享Runner默认采用更严格的网络隔离策略，比如使用docker executor时的默认bridge网络，会限制容器间主机名解析的灵活性。MongoDB副本集的拓扑发现机制需要节点能正确识别自身和客户端的地址，如果你构建的镜像里副本集初始化用的是localhost或容器内部主机名，在共享Runner的隔离环境中，应用容器无法将这些地址映射到Mongo容器的实际IP——哪怕nc能通端口，驱动也无法完成副本集的身份验证，最终出现ReplicaSetGhost错误。

2. 副本集配置的地址不兼容 #

本地docker-compose环境中，容器通过默认网络可以直接解析彼此的容器名，但共享Runner的环境可能会重置网络配置，导致你手动添加的hosts映射被忽略。当副本集配置里的节点地址无法被应用容器正确解析时，就会触发“No host described in new configuration...”这类拓扑发现失败的错误。

3. 共享Runner的资源配额限制 #

共享Runner通常会设置严格的CPU、内存配额，MongoDB 6副本集初始化和运行需要一定的资源支撑，资源不足时会导致节点响应延迟，触发应用的System.TimeoutException。而自定义Runner可以根据你的需求调整资源参数，避免这类问题。

可行的验证与修复方向 #

• 修改副本集初始化配置：启动Mongo容器时指定--bind_ip_all，并在初始化副本集时用容器的实际IP（可通过hostname -i获取）替代localhost，确保应用能正确识别节点地址。
• 统一CI中的网络配置：在GitLab CI脚本中创建自定义Docker网络，让应用容器和Mongo容器加入同一个网络，避免默认bridge网络的隔离限制。
• 动态调整副本集配置：在CI job中启动Mongo容器后，执行mongo命令调用rs.reconfig()，将副本集节点地址修改为当前容器的可访问IP，覆盖镜像中的默认配置。

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