Mongoose连接报错：openUri()的uri参数为undefined如何修复

报错信息 #

启动Node.js项目时抛出如下错误：

The `uri` parameter to `openUri()` must be a string, got "undefined". Make sure the first parameter to `mongoose.connect()` or `mongoose.createConnection()` is a string.

核心原因 #

报错指向Mongoose建立数据库连接时，收到的连接地址参数不是合法字符串，实际拿到的是undefined，也就是代码里的process.env.MONGO_URI环境变量没有被正确加载，没有读到有效的MongoDB连接串。

具体修复步骤 #

• 检查.env文件位置与命名
  确认你执行node index.js启动命令的目录（项目根目录）下存在.env文件，该文件没有任何后缀名，不要命名为env.txt、.env.js之类的错误格式。
• 检查.env内的变量配置
  打开.env文件，确认已经正确写入MONGO_URI配置，变量名全大写，值为你实际使用的MongoDB连接地址（本地库地址或者云数据库连接串），行尾不要加分号，值不要随便套多余引号，格式参考：

  MONGO_URI=mongodb://localhost:27017/task_manage
  PORT=3000
  

• 修正dotenv加载配置
  如果你的.env文件没有放在启动命令所在的根目录，需要在调用dotenv的config方法时手动传入文件路径，比如.env放在starter目录下的话，加载代码改成：

  require('dotenv').config({ path: './starter/.env' })
  

  注意require('dotenv').config()必须写在所有读取process.env属性的代码之前，避免加载顺序问题导致变量读不到。
• 修复数据库连接方法的错误吞噬问题
  你当前的connect.js里在mongoose连接逻辑后直接写了catch捕获错误，但是没有把错误向外抛出，会导致外层启动逻辑拿不到完整错误信息，建议把connect.js改成如下纯async/await写法：

  const mongoose = require('mongoose')
  const connectDB = async (url) => {
      return mongoose.connect(url,{
          useNewUrlParser: true,
          useCreateIndex: true,
          useFindAndModify: false,
          useUnifiedTopology: true,
      })
  }
  module.exports = connectDB
  

• 验证环境变量读取结果
  在index.js里调用connectDB之前加一行打印代码，确认变量是否正常读取：

  console.log('当前读取到的Mongo连接串：', process.env.MONGO_URI)
  

  如果打印结果还是undefined，回头检查变量名拼写、文件路径、文件名是否正确，排除拼写错误。

内容的提问来源于stack exchange，提问作者Harshad.N