GitLab CI/CD中MongoDB副本集服务连接失败问题排查

原因分析 #

核心问题在于副本集成员的地址与GitLab CI服务别名不匹配：

• 你制作的镜像初始化副本集时，成员的主机名大概率设为了localhost或容器内部的默认hostname，而非GitLab CI中配置的服务别名mongors。
• 当客户端使用带replicaSet=rs0的连接字符串时，MongoDB会返回副本集的成员列表（比如localhost:27017），但在GitLab CI的容器网络中，客户端无法通过这个地址访问到副本集节点，导致连接失败。
• 不带replicaSet参数时是单节点直连模式，不需要获取成员列表，因此能正常连通。

解决办法 #

1. 修改镜像的副本集初始化脚本 #

在镜像启动时的副本集初始化命令中，将成员主机名明确指定为mongors：

rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "mongors:27017" }
  ]
})

这样副本集返回的成员地址就是GitLab CI网络中可解析的mongors:27017，客户端能正常连接所有节点。

2. 在GitLab CI配置中同步容器hostname #

如果无法修改镜像脚本，可以在.gitlab-ci.yml的服务配置里，将容器的hostname设置为和别名一致的mongors：

services:
  - name: 你的MongoDB副本集镜像名
    alias: mongors
    hostname: mongors

这样镜像内部初始化副本集时，若使用容器自身hostname作为成员地址，会自动匹配外部访问的别名。

验证方法 #

在GitLab CI的测试job中，执行以下命令确认副本集配置：

mongosh mongodb://mongors:27017 --eval "rs.conf()"

查看输出中members[0].host的值，确保是mongors:27017而非localhost:27017或其他无法解析的地址。

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