Node.js连接MongoDB集群报错，教程正常本地运行失败如何解决？

可按以下顺序逐一排查： #

• 补充错误捕获逻辑获取具体报错信息
  现有代码仅处理了连接成功的场景，缺少错误捕获，可将mongoose连接部分修改为以下代码，打印具体错误信息方便定位：

  mongoose.connect(
    `mongodb+srv://${process.env.MONGO_DB_USER}:${process.env.MONGO_DB_PASSWORD}@cluster0.9ylhh.mongodb.net/${process.env.MONGO_DB_DATABASE}?retryWrites=true&w=majority`,
    // mongoose 6.x+ 版本可删除以下配置项，已默认开启
    {
      useNewUrlParser: true,
      useUnifiedTopology: true,
      useCreateIndex: true
    }
  ).then(() => {
    console.log('Database connected');
  }).catch(err => {
    console.error('Mongo连接错误详情：', err);
  });
  

• 校验.env配置是否正常生效
  首先确认.env文件放在项目根目录（与入口js文件同级），在env.config()代码后添加以下打印逻辑，确认三个Mongo相关环境变量都能正常读取，没有出现undefined、拼写错误的情况：

  console.log('环境变量校验：', process.env.MONGO_DB_USER, process.env.MONGO_DB_PASSWORD, process.env.MONGO_DB_DATABASE);
  

• 检查Mongo Atlas平台权限配置
  • 确认本地网络的公网IP已添加到Atlas控制台「Network Access」的IP白名单中，临时测试可设置为0.0.0.0/0开放所有IP访问，验证连通后再调整为实际使用的IP
  • 确认使用的数据库用户拥有目标库的读写权限，若密码包含@、/、?等URL特殊字符，需要先做URL编码后再填入.env文件
• 适配mongoose版本差异
  如果你使用的是mongoose 6.x及以上版本，useNewUrlParser、useUnifiedTopology、useCreateIndex三个配置项已经默认开启，手动传入反而会触发兼容报错，直接删除这部分配置即可。
• 排查本地网络限制
  关闭本地代理、VPN后重试，也可以使用MongoDB Compass工具填入相同的连接串测试连接，如果Compass也无法连通，说明是网络或者Atlas配置问题，和业务代码无关。

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