NestJS项目运行npm start报TypeError [ERR_INVALID_URL]错误求助

错误根因 #

报错是MongoDB连接字符串格式不符合规范导致的，Mongoose初始化数据库连接时解析URL失败触发了该错误。

排查步骤 #

• 先核对MongoDB连接串的拼接逻辑，标准的本地/自建MongoDB连接串格式为：

  mongodb://<DB_USERNAME>:<DB_PASSWORD>@<DB_HOST>:<DB_PORT>/<DB_DATABASE>
  

  如果你本地测试未开启数据库鉴权，可以省略账号密码部分，格式为：

  mongodb://<DB_HOST>:<DB_PORT>/<DB_DATABASE>
  

• 检查.env文件的配置值是否正确：
  • 不要直接用port作为DB_PORT的取值，MongoDB默认端口为27017，需要替换为你实际使用的端口
  • DB_HOST不要携带http:///https://前缀，也不要有多余的斜杠、空格，本地测试填127.0.0.1或localhost即可，远程服务填正确的IP或域名
  • 如果你的数据库密码包含@、:、/这类特殊字符，必须先做URL编码，否则会被识别为连接串的分隔符，破坏整体格式
• 确认NestJS已正确加载.env配置：
  新手常忘记安装@nestjs/config依赖，或者未在AppModule的imports数组中添加ConfigModule.forRoot()，导致环境变量未被读取，拼接出的连接串包含undefined自然格式错误。你可以在数据库连接逻辑前临时加一行console.log(process.env)，启动项目查看打印的环境变量是否和你填写的一致，若相关DB变量不存在就是配置未加载成功。
• 如果你使用的是MongoDB Atlas云数据库，连接串为mongodb+srv开头的固定格式，建议直接将完整连接串写入.env，不要拆分拼接，降低出错概率。

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