本地Docker容器中MongoDB副本集无法连接问题排查

原因说明 #

• 初始化副本集时，MongoDB默认使用容器ID作为成员的主机地址，该ID仅在Docker内部网络可解析，Windows主机无法识别这个主机名。
• 当使用副本集模式连接时，MongoDB客户端会从副本集配置中获取成员列表，尝试连接容器ID对应的地址，导致主机端抛出Unknown host错误。
• 修改--bind_ip参数无效，因为问题根源不在MongoDB的绑定地址，而在副本集成员的主机名配置。

解决方案 #

步骤1：修改Docker Compose配置，设置固定容器hostname #

更新docker-compose.yml，添加hostname字段确保容器有固定标识：

version: '3.8'

services:
  mongodb:
    image: mongo:latest
    hostname: mongodb-rs0
    command: ["mongod", "--replSet", "rs0", "--bind_ip_all"]
    ports:
      - "27017:27017"

步骤2：重启MongoDB容器 #

停止并重新启动容器，使新配置生效：

docker-compose down
docker-compose up -d

步骤3：重新初始化副本集（使用固定hostname） #

进入容器并通过mongosh初始化副本集，成员地址使用设置的固定hostname：

1. 进入容器：

docker exec -it $(docker-compose ps -q mongodb) mongosh

2. 执行副本集初始化命令：

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

执行后可通过rs.status()查看副本集初始化状态，等待状态变为正常即可。

步骤4：配置Windows主机hosts文件 #

将容器hostname映射到127.0.0.1，让Windows能解析副本集成员地址：

1. 以管理员权限打开C:\Windows\System32\drivers\etc\hosts文件
2. 添加以下内容：

127.0.0.1    mongodb-rs0

3. 保存文件并关闭。

步骤5：测试副本集连接 #

使用3T Studio连接时，使用带副本集参数的连接串即可正常连接：

mongodb://127.0.0.1:27017/?replicaSet=rs0&ssl=false

此时变更流功能也能正常使用。

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