本地连接Azure CosmosDB(MongoDB)遇MongoServerSelectionError求助

问题背景 #

• 部署在Azure Container Apps的Node.js应用连接Azure CosmosDB（Mongo兼容）完全正常
• 本地执行npm run dev -- --open启动时，触发MongoDB连接超时错误：

MongoServerSelectionError: Server selection timed out after 30000 ms
    at Timeout._onTimeout (xyz/node_modules/mongodb/lib/sdam/topology.js:293:38)
    at listOnTimeout (node:internal/timers:559:17)
    at processTimers (node:internal/timers:502:7) {
  reason: TopologyDescription {
    type: 'ReplicaSetNoPrimary',
    servers: Map(1) {
      'my-db.mongo.cosmos.azure.com:10255' => [ServerDescription]
    },
    stale: false,
    compatible: true,
    heartbeatFrequencyMS: 10000,
    localThresholdMS: 15,
    setName: 'globaldb',
    logicalSessionTimeoutMinutes: undefined
  },
  code: undefined,
  [Symbol(errorLabels)]: Set(0) {}
}

• 连接代码：

const options = {
    useUnifiedTopology: true,
    useNewUrlParser: true,
}

client = new MongoClient(mongoConnectionUri, options)
// @ts-ignore
global._mongoClientPromise = client.connect()
clientPromise = global._mongoClientPromise

• 连接字符串：

mongodb://my-db:abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz==@my-db.mongo.cosmos.azure.com:10255/?ssl=true&replicaSet=globaldb&retrywrites=false&maxIdleTimeMS=120000&appName=@my-db@

• 关键现象：
  • 本地Node.js v16.17.1、npm v8.15.0，此前可正常连接，切换WiFi加密为WPA2 Personal后失效
  • 切换移动热点后，同一设备可正常连接远程数据库
  • 本地Az CLI执行az cosmosdb database show --resource-group rgname --name accountname --db-name dbname能正常获取数据库信息
  • 使用mongosh连接也出现相同超时错误
  • 更换Node.js及MongoDB库版本无法解决

解决方案 #

1. 调整WiFi的MTU值 #

WPA2加密可能导致MTU（最大传输单元）适配异常，CosmosDB对数据包大小敏感：

• Windows执行命令：netsh interface ipv4 set subinterface "你的WiFi名称" mtu=1400 store=persistent
• macOS执行命令：sudo ifconfig en0 mtu 1400（en0为WiFi接口，可通过ifconfig确认）
• Linux执行命令：sudo ip link set dev wlan0 mtu 1400

2. 禁用WiFi的IPv6协议 #

部分WPA2网络下IPv6解析存在异常，CosmosDB优先使用IPv4：

• 进入WiFi网络设置，关闭IPv6协议支持，仅保留IPv4
• 重启网络后重新尝试连接

3. 修改MongoDB连接参数，强制直连 #

针对ReplicaSetNoPrimary错误，强制客户端跳过副本集检测直连节点：

• 修改连接选项：

const options = {
    useUnifiedTopology: true,
    useNewUrlParser: true,
    directConnection: true // 新增参数
}

• 或在连接字符串末尾追加&directConnection=true

4. 关闭路由器的客户端隔离功能 #

部分路由器开启WPA2后默认启用AP/客户端隔离，阻止设备访问特定端口：

• 登录路由器管理后台，关闭"AP隔离"或"客户端隔离"选项
• 重启路由器后测试连接

5. 回退加密协议并更新路由器固件 #

临时将WiFi加密改回WPA，如果恢复正常，说明路由器WPA2固件存在兼容性bug：

• 尝试更新路由器官方固件，再切换回WPA2测试

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