Mongoose 报错“The uri parameter to openUri() must be a string, got 'undefined'”，通常是因为环境变量名不一致导致 process.env.MONGODB_URI 读取为 undefined，而 .env 文件中实际定义的是 MONGO_URI。
mongoose 报错“the `uri` parameter to `openuri()` must be a string, got 'undefined'”，通常是因为环境变量名不一致导致 `process.env.mongodb_uri` 读取为 `undefined`，而 `.env 文件中实际定义的是 `mongo_uri`。
这个问题看似复杂，实则源于一个常见却极易被忽略的拼写不一致——环境变量键名不匹配。
在你的 .env 文件中，你正确定义了：
MONGO_URI="mongodb+srv://username:password@cluster0.mongodb.net/?retryWrites=true&w=majority"
但在 server.js 中，你却尝试读取：
mongoose.connect(process.env.MONGODB_URI) // ❌ 错误：MONGODB_URI ≠ MONGO_URI
由于 process.env.MONGODB_URI 从未被声明，Node.js 返回 undefined，而 mongoose.connect() 要求第一个参数必须是字符串，因此触发该错误。
✅ 正确做法是保持键名完全一致：
// server.js（修正后）
dotenv.config();
mongoose
.connect(process.env.MONGO_URI) // ✅ 改为 MONGO_URI
.then(() => console.log("✅ Connected to MongoDB"))
.catch((err) => {
console.error("❌ Connection failed:", err.message);
process.exit(1); // 建议失败时退出进程，避免服务半启动
});
? 额外注意事项：
- 确保 dotenv.config() 在任何依赖环境变量的代码之前调用（推荐放在文件顶部）；
- 检查 .env 文件是否位于项目根目录，且未被 .gitignore 或 IDE 隐藏；
- 可临时添加调试语句验证变量是否加载成功：
console.log("MONGO_URI loaded?", !!process.env.MONGO_URI); // 应输出 true console.log("Raw value:", process.env.MONGO_URI); // 查看是否含意外空格或引号 - 若使用 VS Code，安装 DotENV 插件可高亮语法并提示未定义变量；
- 生产环境中切勿硬编码 URI，始终通过环境变量管理敏感配置。
通过统一环境变量命名，即可快速解决 undefined URI 问题，让 Mongoose 稳定建立连接。
