Node.js与MongoDB开发实战：从基础到高级应用

1. Node.js 操作 MongoDB 完全指南

作为一名长期使用 Node.js 开发全栈应用的老手，我深知数据库操作是后端开发的核心技能。MongoDB 作为最流行的 NoSQL 数据库之一，与 Node.js 的搭配堪称黄金组合。今天我就来分享一套经过实战检验的完整操作方案。

MongoDB 的文档型数据模型特别适合 Node.js 的异步特性，这种组合能轻松应对现代应用的高并发需求。无论你是要开发社交平台、电商系统还是 IoT 数据处理应用，这套技术栈都能提供出色的灵活性和扩展性。接下来我会从环境搭建到高级查询，手把手带你掌握所有关键环节。

2. 环境准备与基础配置

2.1 MongoDB 安装与配置

在开始之前，我们需要确保本地开发环境已经准备就绪。MongoDB 提供了多种安装方式，这里我推荐使用官方提供的社区版：

bash复制# Ubuntu 系统安装示例
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
sudo apt-get update
sudo apt-get install -y mongodb-org

安装完成后，启动 MongoDB 服务：

bash复制sudo systemctl start mongod
sudo systemctl enable mongod

注意：Windows 用户可以从官网下载 MSI 安装包，安装过程有图形界面引导。建议勾选"Install MongoDB as a Service"选项，这样 MongoDB 会作为系统服务自动启动。

2.2 Node.js 环境搭建

Node.js 的安装同样简单，但我强烈建议使用 nvm（Node Version Manager）来管理多个 Node.js 版本：

bash复制# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# 安装指定 Node.js 版本
nvm install 16.14.2
nvm use 16.14.2

验证安装是否成功：

bash复制node -v
npm -v

3. MongoDB 驱动连接与基础操作

3.1 连接 MongoDB 数据库

在 Node.js 中操作 MongoDB，我们通常使用官方的 mongodb 驱动包。首先创建项目并安装依赖：

bash复制mkdir node-mongo-demo
cd node-mongo-demo
npm init -y
npm install mongodb

然后创建 db.js 文件配置数据库连接：

javascript复制const { MongoClient } = require('mongodb');

// 连接URL
const url = 'mongodb://localhost:27017';
// 数据库名
const dbName = 'testdb';

async function connect() {
  const client = new MongoClient(url);
  
  try {
    // 连接数据库
    await client.connect();
    console.log('Connected successfully to server');
    
    const db = client.db(dbName);
    return db;
  } catch (err) {
    console.error('Connection error:', err);
    process.exit(1);
  }
}

module.exports = connect;

3.2 基本 CRUD 操作

掌握了连接方法后，我们来看最基本的增删改查操作。创建一个 operations.js 文件：

javascript复制const connect = require('./db');

async function run() {
  const db = await connect();
  const collection = db.collection('users');
  
  // 插入文档
  const insertResult = await collection.insertMany([
    { name: 'Alice', age: 25, email: 'alice@example.com' },
    { name: 'Bob', age: 30, email: 'bob@example.com' }
  ]);
  console.log('Inserted documents:', insertResult.insertedCount);
  
  // 查询文档
  const findResult = await collection.find({ age: { $gt: 25 } }).toArray();
  console.log('Found documents:', findResult);
  
  // 更新文档
  const updateResult = await collection.updateOne(
    { name: 'Alice' },
    { $set: { age: 26 } }
  );
  console.log('Updated documents:', updateResult.modifiedCount);
  
  // 删除文档
  const deleteResult = await collection.deleteOne({ name: 'Bob' });
  console.log('Deleted documents:', deleteResult.deletedCount);
}

run().catch(console.error);

4. 高级查询与性能优化

4.1 复杂查询操作

MongoDB 的强大之处在于其丰富的查询能力。以下是一些常用高级查询示例：

javascript复制// 多条件查询
const complexFind = await collection.find({
  age: { $gt: 20, $lt: 35 },
  name: { $regex: /^A/ }  // 名字以A开头
}).sort({ age: 1 })  // 按年龄升序
 .limit(10)          // 限制返回10条
 .toArray();

// 聚合查询
const aggregation = await collection.aggregate([
  {
    $match: { age: { $gt: 20 } }  // 筛选条件
  },
  {
    $group: {
      _id: "$age",                // 按年龄分组
      count: { $sum: 1 },         // 计算每组的数量
      names: { $push: "$name" }   // 将名字放入数组
    }
  },
  {
    $sort: { count: -1 }          // 按数量降序
  }
]).toArray();

4.2 索引优化

合理的索引可以大幅提升查询性能。以下是创建和使用索引的最佳实践：

javascript复制// 创建单字段索引
await collection.createIndex({ age: 1 });

// 创建复合索引
await collection.createIndex({ name: 1, age: -1 });

// 查看查询执行计划
const explain = await collection.find({ age: { $gt: 25 } })
                              .explain("executionStats");
console.log(explain.executionStats);

提示：索引虽然能加速查询，但会降低写入性能并占用额外存储空间。通常只为频繁查询的字段创建索引，并避免在频繁更新的字段上创建索引。

5. 实战应用与最佳实践

5.1 分页查询实现

在实际应用中，分页是常见需求。以下是实现高效分页的方案：

javascript复制async function getPaginatedResults(collection, page = 1, pageSize = 10) {
  const skip = (page - 1) * pageSize;
  
  const [data, total] = await Promise.all([
    collection.find()
             .skip(skip)
             .limit(pageSize)
             .toArray(),
    collection.countDocuments()
  ]);
  
  return {
    data,
    total,
    page,
    pageSize,
    totalPages: Math.ceil(total / pageSize)
  };
}

5.2 事务处理

MongoDB 4.0+ 支持多文档事务，适合需要强一致性的场景：

javascript复制const session = client.startSession();

try {
  await session.withTransaction(async () => {
    const accounts = db.collection('accounts');
    
    // 转账操作：从A账户扣除，向B账户增加
    await accounts.updateOne(
      { _id: 'A' },
      { $inc: { balance: -100 } },
      { session }
    );
    
    await accounts.updateOne(
      { _id: 'B' },
      { $inc: { balance: 100 } },
      { session }
    );
  });
} finally {
  session.endSession();
}

6. 常见问题与解决方案

6.1 连接池管理

不当的连接管理会导致性能问题。以下是优化建议：

javascript复制// 最佳实践：创建全局连接并复用
let cachedClient = null;

async function getClient() {
  if (cachedClient) return cachedClient;
  
  const client = new MongoClient(url, {
    poolSize: 10,                // 连接池大小
    connectTimeoutMS: 5000,      // 连接超时
    socketTimeoutMS: 30000       // 操作超时
  });
  
  cachedClient = await client.connect();
  return cachedClient;
}

6.2 错误处理模式

健壮的错误处理是生产环境必备：

javascript复制try {
  // 数据库操作
} catch (error) {
  if (error instanceof MongoServerError) {
    switch (error.code) {
      case 11000:  // 重复键错误
        console.error('Duplicate key error');
        break;
      case 121:    // 文档验证失败
        console.error('Document validation failed');
        break;
      default:
        console.error('MongoDB error:', error);
    }
  } else {
    console.error('Other error:', error);
  }
}

6.3 性能监控

使用 MongoDB 内置工具监控性能：

javascript复制// 启用慢查询日志
db.setProfilingLevel(1, { slowms: 100 });

// 查看慢查询
const slowQueries = await db.collection('system.profile')
                          .find({ millis: { $gt: 100 } })
                          .toArray();

7. 安全最佳实践

7.1 认证与授权

生产环境必须启用认证：

javascript复制// 带认证的连接字符串
const url = 'mongodb://username:password@localhost:27017/testdb?authSource=admin';

// 创建用户
use admin
db.createUser({
  user: "admin",
  pwd: "complexpassword",
  roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
})

7.2 数据验证

使用 schema 验证确保数据完整性：

javascript复制// 创建带验证的集合
await db.createCollection('users', {
  validator: {
    $jsonSchema: {
      bsonType: "object",
      required: ["name", "email"],
      properties: {
        name: { bsonType: "string" },
        email: { 
          bsonType: "string",
          pattern: "^.+@.+\\..+$"
        },
        age: { 
          bsonType: "int",
          minimum: 0 
        }
      }
    }
  }
});

8. 实际项目架构建议

8.1 项目结构组织

合理的项目结构能提高代码可维护性：

code复制project/
├── config/
│   └── db.js          # 数据库配置
├── models/
│   └── userModel.js   # 数据模型
├── services/
│   └── userService.js # 业务逻辑
├── controllers/
│   └── userController.js # 路由处理
└── app.js             # 应用入口

8.2 使用 Mongoose ODM

对于复杂项目，推荐使用 Mongoose：

javascript复制const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/testdb');

// 定义Schema
const userSchema = new mongoose.Schema({
  name: String,
  email: { type: String, required: true, unique: true },
  age: { type: Number, min: 0 }
});

// 创建Model
const User = mongoose.model('User', userSchema);

// 使用示例
const newUser = new User({ name: 'Charlie', email: 'charlie@example.com' });
await newUser.save();

这套 Node.js 操作 MongoDB 的方案已经在我参与的多个生产项目中得到验证，从初创公司的小型应用到大型企业系统都能胜任。关键在于根据实际业务需求选择合适的模式和优化策略，希望这些经验能帮助你快速构建稳健的数据库层。