Docker部署MongoDB ReplicaSet后pymongo无法集群连接

核心原因 #

MongoDB副本集初始化时，节点会将Docker内部的主机名（如mongo1、mongo2）注册到副本集配置中。当客户端通过集群连接串发起请求后，主节点会返回这些内部主机名给客户端，而宿主机无法解析这些仅在Docker网络内有效的主机名，导致连接超时。

解决方案一：修改副本集节点配置为宿主机可访问地址 #

1. 启动容器时允许外部访问
   启动每个MongoDB容器时，添加--bind_ip_all参数，允许所有IP地址访问节点：

   # 示例启动mongo1节点
   docker run -d \
     --name mongo1 \
     -p 27017:27017 \
     mongo:latest \
     mongod --replSet rs0 --bind_ip_all
   
   # 同理启动mongo2、mongo3
   docker run -d \
     --name mongo2 \
     -p 27018:27017 \
     mongo:latest \
     mongod --replSet rs0 --bind_ip_all
   
   docker run -d \
     --name mongo3 \
     -p 27019:27017 \
     mongo:latest \
     mongod --replSet rs0 --bind_ip_all
   

2. 重新配置副本集节点地址
   进入主节点容器，修改副本集配置，将节点的host字段替换为宿主机IP+映射端口：

   docker exec -it mongo1 mongosh
   

   在MongoShell中执行：

   # 若未初始化副本集，执行初始化
   rs.initiate({
     _id: "rs0",
     members: [
       { _id: 0, host: "你的宿主机IP:27017" },
       { _id: 1, host: "你的宿主机IP:27018" },
       { _id: 2, host: "你的宿主机IP:27019" }
     ]
   })
   
   # 若已初始化，修改现有配置
   cfg = rs.conf()
   cfg.members[0].host = "你的宿主机IP:27017"
   cfg.members[1].host = "你的宿主机IP:27018"
   cfg.members[2].host = "你的宿主机IP:27019"
   rs.reconfig(cfg, {force: true})
   

解决方案二：宿主机hosts文件映射内部主机名 #

在宿主机的hosts文件中添加映射，将Docker内部主机名指向宿本机IP：

• Linux/macOS：编辑/etc/hosts
• Windows：编辑C:\Windows\System32\drivers\etc\hosts

添加以下内容：

127.0.0.1 mongo1 mongo2 mongo3

保存后，宿主机就能解析这些内部主机名，通过端口映射访问对应容器节点。

解决方案三：pymongo临时绕过（仅测试用） #

如果只是临时测试需求，可在连接串中添加directConnection=true，强制客户端只连接连接串中指定的节点，不尝试切换到副本集返回的内部主机名：

from pymongo import MongoClient
client = MongoClient("mongodb://localhost:27017,localhost:27018,localhost:27019?replicaSet=rs0&directConnection=true")

注意：该方法会失去副本集自动故障转移能力，不适合生产环境。

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