MongoDB 简明教程

MongoDB Node.js 连接数据库

1. Node.js 连接 MongoDB 简介

在安装好 MongoDB Node.js 驱动程序后,你就可以开始在应用程序中编写连接数据库的代码。建立连接是进行任何数据库操作(如增删改查)的第一步。

2. 创建 MongoClient

要连接到 MongoDB,你首先需要从 mongodb 模块中引入 MongoClient 类。它是驱动程序的核心入口点。

示例代码:

const { MongoClient } = require('mongodb');

3. 配置连接字符串

连接字符串(Connection String)是告知驱动程序如何找到你的数据库的 URL。

  • 本地开发: 通常使用 mongodb://localhost:27017
  • MongoDB Atlas (云端): 使用 Atlas 提供的以 mongodb+srv:// 开头的专用 URI。

4. 执行连接操作

通过调用 client.connect() 方法,你的 Node.js 应用会尝试与指定的 MongoDB 集群握手。

4.1 异步连接示例

在现代 JavaScript 开发中,建议使用 async/await 语法来处理连接过程,这样代码更加简洁且易于维护。

完整连接示例:

const { MongoClient } = require('mongodb');

// 替换为你的连接字符串
const uri = "mongodb://localhost:27017";
const client = new MongoClient(uri);

async function run() {
  try {
    // 尝试连接到服务器
    await client.connect();
    console.log("连接成功!");

    // 指定并访问数据库
    const database = client.db('myDatabase');
    console.log("已访问数据库: " + database.databaseName);
  } finally {
    // 确保无论成功与否,最后都会关闭连接
    await client.close();
  }
}
run().catch(console.dir);

5. 常见注意事项

在编写连接逻辑时,你需要留意以下几点以提升代码的健壮性:

  • 错误处理: 始终使用 try...catch 结构来捕获网络延迟或凭据错误导致的连接失败。
  • 连接池管理: 在实际生产应用中,通常只需要创建一个 MongoClient 实例并在整个应用生命周期内复用它,而不是每次请求都新建连接。
  • 安全性: 切勿在代码中硬编码敏感的用户名和密码。建议使用 .env 环境文件配合 process.env 来管理你的 URI。