外部PyMongo脚本无法连接Docker部署的MongoDB副本集故障排查

报错核心原因是MongoDB副本集的连接逻辑和你预期的不一样：

• 你虽然在连接串里写了localhost:27021,localhost:27022,localhost:27023作为初始种子节点，但客户端和种子节点建立连接后，会直接从副本集拉取所有成员的配置地址，后续所有读写操作、故障切换都直接连接副本集返回的这些成员地址，不会一直用你初始填的种子地址。
• 你初始化副本集时，成员配置里写的一定是Docker内部网络的域名mongo1:27017、mongo2:27017、mongo3:27017，这几个域名只能在你创建的mongors-network桥接网络内部被容器解析，Docker外部的宿主机根本不存在这几个域名的DNS记录，所以客户端拿到这些地址后直接报域名解析失败，和端口映射是否正常没有关系。

方案1：正规副本集连接方案（支持高可用，推荐） #

需要把副本集对外宣告的成员地址改成宿主机可访问的地址，保证容器内外都能正常连通：

1. 先获取宿主机的物理网卡IP（不要用127.0.0.1回环地址），Linux/macOS执行ifconfig、Windows执行ipconfig查看，比如你的宿主机IP是192.168.3.5
2. 进入任意一个Mongo容器修改副本集配置，比如进入mongo1容器：

   docker exec -it mongo1 mongosh
   

   执行以下命令修改成员地址（把IP替换成你自己的宿主机IP）：

   cfg = rs.conf()
   cfg.members[0].host = "192.168.3.5:27021"
   cfg.members[1].host = "192.168.3.5:27022"
   cfg.members[2].host = "192.168.3.5:27023"
   rs.reconfig(cfg, {force: true})
   

3. 等待10-20秒让副本集重新选举完成，把Python脚本里的连接串替换成对应地址即可：

   MONGO_REPLICA_SET_ADDRESS = "mongodb://192.168.3.5:27021,192.168.3.5:27022,192.168.3.5:27023/?replicaSet=dbrs"
   

   这种配置下容器内部可以通过宿主机IP+映射端口连通其他副本集成员，外部客户端也能正常访问，完整保留副本集的高可用能力。

方案2：临时调试方案（不支持高可用） #

如果只是临时测试脚本逻辑，不需要副本集故障转移能力，可以在连接串里加directConnection=true参数，强制客户端直连指定的单个种子节点，不拉取副本集的完整成员列表：

MONGO_REPLICA_SET_ADDRESS = "mongodb://localhost:27021/?replicaSet=dbrs&directConnection=true"

注意这个方案的限制：

• 没有故障转移能力，你连接的27021节点挂了之后连接会直接中断
• 如果27021节点当前是从节点，默认无法执行写入操作，需要额外配置读偏好
• 仅适合本地临时调试，不能用于生产环境

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