Mongosh无法连接远程MongoDB副本集，始终尝试连接本地主机

环境信息 #

• 远程机器运行3个不同端口的MongoDB实例，同属replocal副本集
• 远程MongoDB的bindIp配置为172.31.32.81,127.0.0.1（包含外部和内部IP）

本地MacOS Ventura设备可单独连接每个实例，但无法连接副本集，使用mongosh、Mongo Compass或Studio 3T均出现相同错误：客户端始终尝试连接localhost（本地未运行MongoDB）。

测试示例 #

连接单个主实例（成功） #

$ mongosh "mongodb://172.31.32.81:27017"        
Current Mongosh Log ID: 649b09bca15bc473c95db139
Connecting to:          mongodb://172.31.32.81:27017/?directConnection=true&appName=mongosh+1.10.1
Using MongoDB:          6.0.6
Using Mongosh:          1.10.1

For mongosh info see: https://docs.mongodb.com/mongodb-shell/

------
   The server generated these startup warnings when booting
   ...(edited out , not relevant)...
------

replocal [direct: secondary] test> 

可成功获取远程MongoDB提示符。

连接副本集（失败，指向localhost） #

$ mongosh "mongodb://172.31.32.81:27017,172.31.32.81:27018,172.31.32.81:27019?replicaSet=replocal&readPreference=secondaryPreferred"   
Current Mongosh Log ID: 649b096a40719e3e693048bd
Connecting to:          mongodb://172.31.32.81:27017,172.31.32.81:27018,172.31.32.81:27019/?replicaSet=replocal&readPreference=secondaryPreferred&appName=mongosh+1.10.1
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017

错误：客户端尝试连接localhost（127.0.0.1）。

更换第一个节点端口为非27017（错误指向正确IP） #

$ mongosh "mongodb://172.31.32.81:27016,172.31.32.81:27018,172.31.32.81:27019?replicaSet=replocal&readPreference=secondaryPreferred"  
Current Mongosh Log ID: 649b0d86045a207db47e25f2
Connecting to:          mongodb://172.31.32.81:27016,172.31.32.81:27018,172.31.32.81:27019/?replicaSet=replocal&readPreference=secondaryPreferred&appName=mongosh+1.10.1
MongoNetworkError: connect ECONNREFUSED 172.31.32.81:27016

疑问：是否使用了错误的连接字符串？似乎端口27017会被默认解析为127.0.0.1，忽略指定IP。尝试使用主机名也得到相同结果，求解决方法。

这个问题的核心原因是副本集节点的配置中，host字段使用了localhost而非外部可访问的IP/主机名。

当你连接副本集时，MongoDB客户端会先连接你指定的节点，然后从该节点获取整个副本集的成员列表。如果节点自身配置的host是localhost，客户端就会尝试连接localhost，而非你最初指定的远程IP。

修复步骤 #

1. 登录远程主节点，使用mongosh连接主实例：

   mongosh "mongodb://172.31.32.81:27017"
   

2. 查看当前副本集配置：

   rs.conf()
   

   检查members数组中每个节点的host字段，大概率会看到类似localhost:27017、localhost:27018这样的配置。
3. 更新副本集配置：
   • 先获取配置对象：

     var cfg = rs.conf()
     

   • 修改每个成员的host为远程可访问的IP（或主机名）：

     cfg.members[0].host = "172.31.32.81:27017"
     cfg.members[1].host = "172.31.32.81:27018"
     cfg.members[2].host = "172.31.32.81:27019"
     

   • 应用新配置：

     rs.reconfig(cfg)
     

   注意：执行rs.reconfig()会触发副本集的重新选举，主节点可能会短暂切换，确保业务能容忍这个波动。

4. 验证配置生效：
   再次执行rs.conf()确认所有节点的host已更新为外部IP。
5. 重新连接副本集：
   使用原来的连接字符串再次尝试，此时客户端会获取到正确的节点地址，不会再尝试连接localhost。

补充说明 #

• 单个节点连接正常是因为mongosh默认添加directConnection=true参数，客户端不会去获取副本集成员列表，直接连接指定的IP:端口。
• 更换第一个节点为非27017端口时错误指向正确IP，是因为客户端尝试连接你指定的IP:27016，但该端口无MongoDB实例运行，错误被提前触发，本质还是副本集配置问题。

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