使用Mongoose与Nodemon无法连接MongoDB Atlas的问题

问题描述 #

在VS Code终端的项目后端目录执行nodemon server命令时，出现Mongoose无法连接MongoDB Atlas集群的错误，核心报错为MongooseServerSelectionError: Could not connect to any servers in your MongoDB Atlas cluster，所有分片节点均返回connect ETIMEDOUT。

已完成的配置：

• 创建了拥有atlasAdmin@admin权限的数据库用户
• 网络访问规则设置为0.0.0.0/0（允许所有IP访问）

后端核心代码server.js如下：

const express = require('express');
const cors = require('cors');
const mongoose = require('mongoose');

require('dotenv').config();

const app = express();
const port = process.env.PORT || 5000;

app.use(cors());
app.use(express.json());

const uri = process.env.ATLAS_URI;
mongoose.connect(uri, {});

const connection = mongoose.connection;
connection.once('open', () => {
    console.log("MongoDB database connection established successfully");
})

app.listen(port, () => {
    console.log(`Server is running on port: ${port}`);
});

解决办法 #

1. 检查连接字符串有效性 #

• 确认.env文件中的ATLAS_URI格式完全正确：必须包含用户名、密码、集群地址，且带有必要参数，示例格式为mongodb+srv://<用户名>:<密码>@cluster0.jmuakrd.mongodb.net/?retryWrites=true&w=majority
• 若密码包含特殊字符（如@、#、$），需先进行URL编码后再填入连接字符串

2. 排查本地网络限制 #

• 关闭本地防火墙、VPN或代理工具，重试连接——部分网络环境会拦截27017端口的对外请求
• 切换至手机热点网络测试，排除固定网络的路由限制
• 用telnet ac-zltfugd-shard-00-00.jmuakrd.mongodb.net 27017命令测试端口是否可达（若连接失败，说明网络层面存在拦截）

3. 升级依赖版本 #

旧版Mongoose或MongoDB驱动可能与新版Atlas集群存在兼容性问题：

npm install mongoose@latest mongodb@latest

升级完成后重启服务重试

4. 补充必要的连接选项 #

在mongoose.connect中添加超时、重试等参数，提升连接稳定性：

mongoose.connect(uri, {
  dbName: '你的目标数据库名称',
  retryWrites: true,
  w: 'majority',
  connectTimeoutMS: 30000,
  socketTimeoutMS: 45000
});

// 添加错误监听，方便定位问题
connection.on('error', (err) => {
  console.error('MongoDB连接错误:', err);
});

5. 验证Atlas集群状态 #

• 登录MongoDB Atlas控制台，确认集群处于正常运行状态（无维护、暂停标记）
• 用MongoDB Compass工具直接使用相同连接字符串测试，验证用户名、密码的有效性

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