NodeJS MongoDB驱动设ssl参数引发ReplicaSetNoPrimary连接超时问题

这个问题的核心是参数类型不匹配加上驱动的参数解析逻辑导致的，具体细节如下：

1. 环境变量的类型陷阱 #

环境变量的值在Node.js中默认都是字符串类型——哪怕你设置的是MONGO_SSL=true，process.env.MONGO_SSL拿到的也是字符串"true"，而非布尔值true。

MongoDB Node.js驱动对ssl参数的要求是布尔值：如果传入非布尔值（比如字符串），会被驱动视为false。这就意味着你代码里显式设置的ssl: process.env.MONGO_SSL，实际上是禁用了SSL连接，完全和你预期的相反。

2. 为什么会触发连接失败？ #

你的MongoDB集群要求SSL连接（DSN里已经明确写了ssl=true），当驱动尝试以非SSL方式连接时，集群会直接关闭未加密的连接请求，这就是你看到connection <monitor> to {IP_ADDRESS}:27017 closed错误的原因。

同时，因为副本集的拓扑监控心跳连接无法通过SSL建立，驱动无法发现副本集的主节点，所以拓扑状态会变成ReplicaSetNoPrimary，最终抛出MongoServerSelectionError。

3. 为什么移除ssl配置后能成功？ #

当你不手动设置ssl选项时，驱动会自动从DSN的查询字符串中解析参数：DSN里的ssl=true会被正确解析为布尔值true，驱动因此启用SSL连接，自然就能正常和集群通信、完成副本集拓扑发现了。

补充：关于驱动参数优先级 #

确实，驱动中显式在connect选项里设置的参数优先级会高于DSN中的对应参数，但前提是你传递的参数值类型是正确的。这里因为字符串类型的"true"被误判为false，才覆盖了DSN中正确的SSL配置，导致连接失败。

解决方案 #

如果你想保留手动设置ssl选项的方式，需要先把环境变量的值转换为布尔值：

const conn = await client.connect(
  process.env.MONGO_DSN,
  {
    useUnifiedTopology: true,
    ssl: process.env.MONGO_SSL === 'true', // 转换为布尔值
  },
)

更推荐的方式是直接依赖DSN中的配置，这样既能避免类型转换的陷阱，也能让所有连接配置集中在一处，更易于维护。

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