使用MongooseModule.forRoot()时NestJS无法连接MongoDB

• 检查连接字符串准确性

  • 确认用户名、密码中的特殊字符已做URL编码（如@替换为%40，#替换为%23），避免解析错误。
  • 核对数据库名称，Atlas默认连接字符串中的test需替换为实际使用的数据库名。
  • 确保连接字符串包含authSource=admin参数，Atlas默认要求该认证源。

• 验证Mongoose版本兼容性

  • 旧版Mongoose可能不支持Atlas的SCRAM-SHA-256认证机制，执行npm install mongoose@latest升级至最新稳定版后重试。

• 显式配置连接选项
  在MongooseModule.forRoot()中手动指定连接参数，强制适配Atlas要求：

  MongooseModule.forRoot(process.env.MONGODB_URI, {
    authMechanism: 'SCRAM-SHA-256',
    ssl: true,
    retryWrites: true,
    w: 'majority'
  })
  

• 确认环境变量配置

  • 若使用环境变量存储连接字符串，检查NestJS是否正确读取（如通过ConfigModule加载时，确保.env文件路径正确、变量名无拼写错误）。
  • 临时打印连接字符串（console.log(process.env.MONGODB_URI)），确认与mongosh/MongoDB Studio使用的完全一致。

• 排查网络环境差异

  • 若NestJS运行在Docker容器中，检查容器网络配置，确保允许出站访问Atlas集群；可尝试使用host网络模式测试。
  • 本地开发时，临时关闭VPN、代理软件，排除网络拦截影响。

• 重置连接缓存
  重启NestJS应用，并在Atlas控制台重启集群节点，清除可能存在的连接缓存。

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