Node.js连接MongoDB Atlas失败求助：URI格式错误问题排查

错误原因分析 #

报错MongoAPIError: URI must include hostname, domain name, and tld说明MongoDB连接字符串格式无效，无法解析合法的主机地址。同时代码中还存在两处路由相关的问题，可能影响后续功能正常运行。

解决步骤 #

1. 正确配置MongoDB Atlas连接字符串 #

确保完全替换连接字符串中的占位符：

• username：MongoDB Atlas中创建的数据库用户用户名（非Atlas账号邮箱）
• password：数据库用户的密码，若密码包含@、:等特殊字符，需做URL编码（例如@替换为%40）
• clustername：你的集群实际名称（可在Atlas控制台集群列表中查看）

正确的连接字符串示例：

"mongodb+srv://my_db_user:my_encoded_password@cluster0.ox93pg1.mongodb.net/?retryWrites=true&w=majority"

2. 验证Atlas权限与IP白名单 #

• 确认数据库用户拥有读写权限：在Atlas控制台Database Access页面检查用户权限配置
• 配置IP白名单：在Atlas控制台Network Access页面，将当前IP地址加入白名单，或暂时设置为0.0.0.0/0（允许所有IP，仅用于测试环境）

3. 修正代码中的路由错误 #

• 路由模块引用错误：noteRouter错误引用了userRoutes，需改为对应路由文件
• 路由路径缺失斜杠：app.use("notes", noteRouter)应添加开头斜杠，否则会被识别为相对路径

修正后的完整代码 #

const express = require("express");
const app = express();
const userRouter = require("./routes/userRoutes");
// 修正noteRouter的引用路径
const noteRouter = require("./routes/noteRoutes");

const mongoose = require("mongoose");

app.use("/users", userRouter);
// 修正路由路径，添加开头斜杠
app.use("/notes", noteRouter);

app.get("/", (req, res) => {
  res.send("Hello");
});

mongoose
  .connect(
    // 替换为你的实际连接字符串
    "mongodb+srv://your_db_user:your_encoded_password@your_cluster.ox93pg1.mongodb.net/?retryWrites=true&w=majority"
  )
  .then(() => {
    app.listen(5000, () => {
      console.log("server started on port no. 5000");
    });
  })
  .catch((err) => {
    console.log(err);
  });

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