无法连接MongoDB副本集：设置loadBalanced=false仍报参数不兼容错误

问题原因 #

MongoDB驱动不允许loadBalanced和replicaSet参数同时出现在连接字符串中——哪怕你把loadBalanced设为false也不行，驱动只要检测到这两个参数共存就会抛出MongoParseError。

loadBalanced是专为负载均衡型集群（比如Atlas免费版M0/M2/M5）设计的参数，而replicaSet用于指定副本集集群，二者属于互斥的连接模式，不能同时启用。

解决方案 #

直接从连接字符串中移除loadBalanced=false参数即可，当你指定replicaSet时，驱动会自动切换到副本集连接模式，无需额外配置负载均衡相关参数。

修正后的连接字符串：

mongodb+srv://${process.env.DB_USERNAME}:${process.env.DB_PASSWORD}@${process.env.DB_CLUSTER}/?replicaSet=rs0&readPreference=secondaryPreferred

修正后的连接代码：

const uri = `mongodb+srv://${process.env.DB_USERNAME}:${process.env.DB_PASSWORD}@${process.env.DB_CLUSTER}/?replicaSet=rs0&readPreference=secondaryPreferred`;
const client = new MongoClient(uri, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
});

await client.connect();

额外注意 #

如果使用的是MongoDB Atlas集群，要确认你的集群规格支持副本集模式：

• 免费版M0/M2/M5集群默认是负载均衡模式，不支持变更流，需要升级到M10及以上规格的副本集集群才能使用变更流功能。
• 自行搭建的副本集集群则直接使用上述修正后的连接方式即可。

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