MERN Stack报错：Cannot read properties of undefined (reading 'startsWith')

错误信息 #

TypeError: Cannot read properties of undefined (reading 'startsWith')
    at connectionStringHasValidScheme (D:\Development\Mern Stack\Backend\node_modules\mongodb-connection-string-url\lib\index.js:9:30)
    at new ConnectionString (D:\Development\Mern Stack\Backend\node_modules\mongodb-connection-string-url\lib\index.js:85:34)

问题原因 #

这个错误的核心是MongoDB连接字符串未被正确传入，变成了undefined，导致代码尝试调用startsWith方法时触发类型错误。

解决步骤 #

• 核对环境变量：检查存储连接字符串的环境变量（如MONGODB_URI）是否拼写正确，启动项目前是否已加载该环境变量。比如Node.js中通过process.env.MONGODB_URI获取时，要确保这个值不是undefined。
• 验证连接字符串完整性：从MongoDB Atlas控制台复制的连接字符串必须完整，确认开头是mongodb+srv://或mongodb://，且已替换掉<username>、<password>、<dbname>这类占位符。
• 检查连接逻辑代码：确保创建MongoDB客户端实例时正确传入了连接字符串，可添加兜底值避免undefined传入，示例：

const mongoose = require('mongoose');
const connectDB = async () => {
  try {
    await mongoose.connect(process.env.MONGODB_URI || 'mongodb://localhost:27017/localdb');
    console.log('数据库连接成功');
  } catch (err) {
    console.error(err);
    process.exit(1);
  }
};

• 重启环境与项目：若刚修改过环境变量，需重启终端和项目，确保新配置生效。

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