Node.js+TypeScript项目中Mongoose连接MongoDB报错如何解决

Node.js + TypeScript 项目运行时Mongoose连接MongoDB抛出异常，相关报错、代码截图如下：

• 第一部分报错信息：
  
• 第二部分报错信息：
  
• 项目代码截图1：
  
• 项目代码截图2：
  

• 连接URI配置错误：从代码可见连接字符串存在占位符未替换、地址/端口不匹配问题，本地连接默认端口为27017，云数据库连接串需替换完整账号、密码、集群地址参数，否则会直接触发服务选择失败。
• 数据库服务或网络权限异常：本地连接场景下大概率是mongod服务未启动、防火墙拦截27017端口；云数据库（如MongoDB Atlas）场景下为当前出口IP未加入白名单、账号密码错误、账号无对应库读写权限。
• 代码逻辑缺失：mongoose.connect()为异步方法，现有代码未加await等待连接完成、未做异常捕获，连接未就绪时就执行后续Model初始化、数据库读写操作，直接触发连接未就绪错误；部分低版本Mongoose未传兼容配置参数也会触发兼容类报错。
• 版本不兼容：Mongoose版本与MongoDB服务大版本不匹配，例如Mongoose 7.x 最低要求MongoDB 3.6及以上版本，版本差过大会导致连接握手失败。

按优先级依次排查修复：

1. 验证基础服务连通性
   • 本地连接场景：先启动MongoDB服务
     • Windows管理员权限执行net start MongoDB
     • Mac/Linux执行sudo systemctl start mongod，Homebrew安装版本执行brew services start mongodb-community
     • 服务启动后执行mongosh，能正常进入交互shell说明本地服务运行正常
   • 云数据库连接场景：先登录云控制台将当前设备公网IP加入IP白名单，核对连接串中账号、密码、集群地址全部替换为实际值，密码含特殊字符时需做URL转义。
2. 修正连接逻辑代码
   改为异步等待连接完成后再启动业务服务，添加异常捕获，TS环境参考实现如下：

   import mongoose from 'mongoose';
   // 建议连接串存放在环境变量中，避免硬编码泄露
   const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://127.0.0.1:27017/你的业务库名';
   
   async function initMongoConnection() {
     const conn = await mongoose.connect(MONGODB_URI, {
       // Mongoose 6.x以下版本需手动添加以下配置，高版本已默认开启可省略
       useNewUrlParser: true,
       useUnifiedTopology: true,
     });
     console.log(`MongoDB连接成功，实例地址：${conn.connection.host}`);
   }
   
   // 等待数据库连接完成后再启动HTTP服务、注册路由
   initMongoConnection()
     .then(() => {
       const app = require('./app').default;
       app.listen(3000, () => console.log('服务已启动在3000端口'));
     })
     .catch(err => {
       console.error('MongoDB连接失败，进程退出：', err);
       process.exit(1);
     });
   

3. 核对版本适配关系
   执行npm list mongoose mongodb查看依赖版本，Mongoose与MongoDB版本对应可参考官方兼容表，常用稳定组合为Mongoose 6.x 对应 MongoDB 4.x/5.x，版本不匹配时要么升级MongoDB服务，要么降级Mongoose到兼容版本。
4. 其他排查点
   • 开启VPN/系统代理时先关闭再尝试连接，代理可能导致云数据库连接路由异常
   • Docker部署MongoDB时核对容器端口映射规则，确认27017端口已映射到宿主机、容器处于运行状态
   • 核对连接串中指定的数据库名存在，连接使用的账号拥有该库的读写权限

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