Node.js应用无法连接Mongoose至MongoDB Atlas的问题求助

问题概述 #

使用Node.js v18.16.0 + Mongoose连接MongoDB Atlas时，出现MongooseServerSelectionError，核心错误为ERR_SSL_TLSV1_ALERT_INTERNAL_ERROR，已设置IP白名单（包括允许所有地址）但仍无法连接。

代码示例 #

const express = require('express');
const mongoose = require('mongoose');
const dns = require('dns');
dns.setDefaultResultOrder('ipv4first');

const app = express();
mongoose.set('debug', true);
mongoose.connect("mongodb+srv://username:password@tryingip.vfri4.mongodb.net/myDatabase?retryWrites=true&w=majority", {
    serverSelectionTimeoutMS: 5000 // 设置连接超时
})
.then(() => console.log("Connected to MongoDB Atlas"))
.catch(err => console.error("Connection error:", err));

错误信息 #

MongooseServerSelectionError: Could not connect to any servers in your MongoDB Atlas cluster. One common reason is that you're trying to access the database from an IP that isn't whitelisted. Make sure your current IP address is on your Atlas cluster's IP whitelist: https://www.mongodb.com/docs/atlas/security-whitelist/
    at _handleConnectionErrors (/Users/adityaverma/Desktop/trying ass8/node_modules/mongoose/lib/connection.js:909:11)
    at NativeConnection.openUri (/Users/adityaverma/Desktop/trying ass8/node_modules/mongoose/lib/connection.js:860:11) {
  reason: TopologyDescription {
    type: 'ReplicaSetNoPrimary',
    servers: Map(3) {
      'mongo8-shard-00-02.hu8hm.mongodb.net:27017' => ServerDescription {
        address: 'mongo8-shard-00-02.hu8hm.mongodb.net:27017',
        type: 'Unknown',
        error: MongoNetworkError: 409CBCD701000000:error:0A000438:SSL routines:ssl3_read_bytes:tlsv1 alert internal error:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1605:SSL alert number 80
        // 省略其他错误详情
      }
    }
  }
}

解决方法 #

1. 确保Mongoose与Node.js版本兼容 #

Node.js v18需要Mongoose 6.8.0及以上版本，或7.x系列稳定版。执行以下命令升级：

npm install mongoose@latest

2. 显式指定TLS版本 #

在连接选项中添加tlsVersion参数，强制使用MongoDB Atlas要求的TLS 1.2或1.3：

mongoose.connect("mongodb+srv://username:password@tryingip.vfri4.mongodb.net/myDatabase?retryWrites=true&w=majority", {
    serverSelectionTimeoutMS: 5000,
    tlsVersion: 'TLS1.2' // 或'TLS1.3'
})

3. 验证连接字符串正确性 #

检查连接字符串中的集群地址、用户名、密码是否与Atlas控制台提供的一致。注意错误信息中显示的服务器地址是hu8hm.mongodb.net，但代码中用的是tryingip.vfri4.mongodb.net，确认是否复制错误。

4. 临时禁用SSL验证（仅测试环境） #

如果是本地测试环境，可以临时关闭SSL验证排查问题（生产环境禁止使用）：

mongoose.connect("mongodb+srv://username:password@tryingip.vfri4.mongodb.net/myDatabase?retryWrites=true&w=majority", {
    serverSelectionTimeoutMS: 5000,
    sslValidate: false
})

5. 重置Atlas网络规则 #

登录MongoDB Atlas控制台，进入集群的网络访问设置，重新保存IP白名单（即使已经设置0.0.0.0/0），触发网络配置更新。

6. 调整DNS设置 #

尝试切换DNS服务器（如谷歌DNS 8.8.8.8），或清除本地DNS缓存：

• macOS：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Windows：ipconfig /flushdns

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