本地Docker环境MongoDB副本集连接端口异常问题咨询

问题原因 #

当你初始化MongoDB副本集时，每个节点会将自身的监听地址和端口注册到副本集的配置文档中。由于你的容器内部MongoDB使用默认端口27017，副本集配置里记录的节点地址是mongo0:27017、mongo1:27017、mongo2:27017。

当你在主机上使用副本集连接字符串时，驱动的工作流程是：

1. 先连接你指定的节点（比如mongo0:35000）
2. 从该节点获取副本集的完整配置信息
3. 按照配置里的节点地址（mongo0:27017等）尝试建立连接

而你的hosts文件将mongo0映射到127.0.0.1，但主机的27017端口并未映射到容器的27017端口，因此出现ECONNREFUSED 127.0.0.1:27017错误。

容器内部能正常连接，是因为容器内mongo0对应的是容器自身的IP，端口27017正是MongoDB的监听端口，不存在端口不匹配的问题。

解决方法与连接建议 #

1. 初始化副本集时指定主机映射端口（推荐） #

在初始化副本集时，直接将节点地址设置为主机可访问的主机名+映射端口，替换容器内部的27017端口。执行以下初始化命令：

rs.initiate({
  _id: "rst",
  members: [
    { _id: 0, host: "mongo0:35000" },
    { _id: 1, host: "mongo1:35001" },
    { _id: 2, host: "mongo2:35002" }
  ]
})

这样副本集配置里的节点地址就是主机能直接访问的端口，驱动获取配置后会正确连接35000/35001/35002，不会再尝试连接27017。

2. 调整容器端口映射到主机不同IP的27017端口 #

如果你的主机有多个可用IP（比如127.0.0.1、127.0.0.2、127.0.0.3），可以将每个容器的27017端口映射到不同的主机IP：

# mongo0 映射到127.0.0.1:27017
docker run -d -p 127.0.0.1:27017:27017 --name mongo0 mongo:latest --replSet rst
# mongo1 映射到127.0.0.2:27017
docker run -d -p 127.0.0.2:27017:27017 --name mongo1 mongo:latest --replSet rst
# mongo2 映射到127.0.0.3:27017
docker run -d -p 127.0.0.3:27017:27017 --name mongo2 mongo:latest --replSet rst

然后在hosts文件中添加：

127.0.0.1 mongo0
127.0.0.2 mongo1
127.0.0.3 mongo2

这样副本集配置里的mongo0:27017会对应到主机的127.0.0.1:27017，能够正常连接。

3. 使用directConnection=true临时调试（仅测试用） #

如果只是临时需要连接单个节点，可以在连接字符串中添加directConnection=true，绕过副本集节点发现流程：

mongodb://mongo0:35000,mongo1:35001,mongo2:35002?replicaSet=rst&directConnection=true

注意：这个选项会让驱动仅连接你指定的第一个节点，不会自动切换到其他副本集节点，仅适合临时调试，不适合生产环境使用。

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