使用Mongoose和Node.js连接MongoDB Atlas失败求助

问题概述 #

我在使用Mongoose结合Node.js连接MongoDB Atlas云数据库时遭遇连接失败，已完成部分排查步骤但仍未解决问题，请求协助定位并修复。

相关代码文件 #

app.js #

const connectDB = require("./db/connect");
require("dotenv").config()
const express = require('express');
const app = express();
const url = process.env.MONGO_URI;
const port = 8080;

// 启动服务与数据库连接
const start = async () => {
  try {
    await connectDB(url);
    app.listen(port, () => {
      console.log("Connected To DB + App is listening on http://localhost:${port}");
    });
  } catch (error) {
    console.log(error);
  }
};

start();

connect.js #

mongoose.set('strictQuery', true);
const connectDB = (url) => {
    return mongoose.connect(url)
}
module.exports = connectDB;

.env 文件配置 #

MONGO_URI =mongodb+srv://<username>:<password>@cluster0.prrizft.mongodb.net/TaskManager?retryWrites=true&w=majority

已完成的排查步骤 #

• 确认MongoDB Atlas连接字符串中的用户名、密码完全正确
• 已在Atlas控制台配置网络白名单，包含0.0.0.0/0（允许所有IP）及当前本地公网IP
• 使用Mongo Compass输入相同的连接字符串，可正常连接并对数据库进行读写操作

错误信息 #

连接时抛出两类核心错误：

1. MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017
2. MongoNetworkError: failed to connect to server [cluster0-shard-00-00.prrizft.mongodb.net:27017] on first connect [Error: connect ETIMEDOUT <IP地址>:27017

排查修复建议 #

1. 补全模块引入

   • 在connect.js顶部添加mongoose引入：const mongoose = require('mongoose');，否则会因mongoose未定义导致连接逻辑失效
   • 确认app.js已引入express模块：const express = require('express');，否则express()调用会报错

2. 修正配置与语法问题

   • 移除.env中MONGO_URI赋值的多余空格，改为MONGO_URI=mongodb+srv://...，避免读取到包含空格的无效连接字符串
   • 将app.js中console.log的双引号改为反引号，正确解析模板变量：console.log(Connected To DB + App is listening on http://localhost:${port});

3. 验证环境变量读取

   • 在start函数中添加日志验证变量是否正确加载：

     console.log('加载的MongoDB地址:', url);
     

   • 确保dotenv.config()调用在读取process.env.MONGO_URI之前

4. 调整连接参数

   • 给mongoose连接添加超时与兼容配置，解决网络延迟问题：

     const connectDB = (url) => {
         return mongoose.connect(url, {
             useNewUrlParser: true,
             useUnifiedTopology: true,
             serverSelectionTimeoutMS: 5000,
             socketTimeoutMS: 45000
         })
     }
     

5. 网络排查

   • 检查本地防火墙、代理是否阻止了27017端口的对外连接，暂时关闭防火墙测试连接
   • 切换网络环境（如手机热点），排除本地网络运营商的端口限制

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