NestJS连接MongoDB Cloud报错MongoParseError: URI malformed如何解决？

报错触发原因 #

你遇到的MongoParseError: URI malformed错误是MongoDB驱动无法正确解析传入的连接URI导致的，从你提供的代码来看，核心问题是连接串结构不完整：
你当前的连接串为：
mongodb+srv://icfoajscijwq90j@cluster0.8rxa2.mongodb.net/nest-js-db?retryWrites=true&w=majority
标准MongoDB Atlas连接串的格式要求是：
mongodb+srv://<用户名>:<密码>@<集群地址>/<数据库名>?<连接参数>
你只填写了用户名icfoajscijwq90j，缺少了冒号分隔的密码段，直接拼接了@集群地址，破坏了URI的结构导致解析失败。
另外你连接串参数里的&是HTML转义后的字符，实际在JS代码里直接使用&作为参数分隔符即可，转义后的字符也会干扰URI解析。

账号密码编码相关说明 #

如果你的密码中包含URI保留字符（包括但不限于@、:、/、?、#、[、]、%），必须对密码单独做URL编码，否则特殊字符会被识别为URI的结构分隔符，同样会触发解析错误。
你可以用JS内置的encodeURIComponent()方法处理密码，示例如下：

const rawPassword = '你的原始密码';
const encodedPassword = encodeURIComponent(rawPassword);
const uri = `mongodb+srv://icfoajscijwq90j:${encodedPassword}@cluster0.8rxa2.mongodb.net/nest-js-db?retryWrites=true&w=majority`

修复后的代码示例 #

直接补全密码、修正参数分隔符即可，以下是修改后的App模块代码：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';
import { UsersModule } from './users/users.module';
import {MongooseModule} from '@nestjs/mongoose'
// 注意替换为你自己的真实密码，有特殊字符先做编码
@Module({
  imports: [UsersModule,MongooseModule.forRoot('mongodb+srv://icfoajscijwq90j:替换为你的编码后密码@cluster0.8rxa2.mongodb.net/nest-js-db?retryWrites=true&w=majority')],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

建议后续把连接串、账号密码这类敏感信息放到环境变量中管理，不要硬编码在业务代码里。

内容的提问来源于stack exchange，提问作者Samiur Rahaman Khan