MongoDB 基本使用指南：从入门到实践

MongoDB作为一款基于文档的非关系型数据库（NoSQL），以其灵活的数据模型、水平扩展能力和高性能查询特性，成为现代应用开发的热门选择。本文将从基础环境搭建到核心功能实践，系统梳理MongoDB的基本使用方法，帮助开发者快速上手并解决实际开发中的常见问题。

一、MongoDB环境搭建与基础配置

1.1 安装与启动

MongoDB支持Windows、Linux和macOS等多平台部署。以Linux环境为例，可通过官方仓库或直接下载二进制包安装：

# 使用apt安装（Ubuntu/Debian）
sudo apt-get install -y mongodb-org
# 启动服务
sudo systemctl start mongod
# 验证服务状态
sudo systemctl status mongod

安装完成后，默认监听端口为27017，可通过mongo命令行工具连接：

mongo --host 127.0.0.1 --port 27017

1.2 配置文件优化

MongoDB的核心配置文件mongod.conf支持参数化配置，例如：

storage:
  dbPath: /var/lib/mongodb
  journal:
    enabled: true
net:
  bindIp: 0.0.0.0  # 允许远程连接
  port: 27017
security:
  authorization: enabled  # 启用认证

关键建议：生产环境务必启用认证（authorization: enabled），并通过db.createUser()创建角色化用户，避免使用默认的无认证模式。

二、数据模型设计：文档与集合

2.1 文档结构

MongoDB以BSON格式存储文档，支持嵌套数组和对象。例如，一个用户文档可能包含：

{
  "_id": ObjectId("507f1f77bcf86cd799439011"),
  "name": "John Doe",
  "age": 30,
  "address": {
    "street": "123 Main St",
    "city": "New York"
  },
  "tags": ["developer", "mongodb"]
}

设计原则：

• 扁平化优先：减少嵌套层级，避免超过3层。
• 冗余与引用平衡：高频访问的数据可冗余存储，低频数据通过$lookup聚合操作关联。

2.2 集合与分片

集合是文档的容器，无需预先定义模式。对于大规模数据，可通过分片（Sharding）实现水平扩展：

// 启用分片并指定分片键
sh.enableSharding("mydb")
sh.shardCollection("mydb.users", { "userId": 1 })

分片策略选择：

• 哈希分片：适用于均匀分布的键（如用户ID）。
• 范围分片：适用于有序查询的键（如时间戳）。

三、CRUD操作：核心查询方法

3.1 插入文档

使用insertOne()或insertMany()插入数据：

// 插入单个文档
db.users.insertOne({ name: "Alice", age: 25 });
// 批量插入
db.users.insertMany([
  { name: "Bob", age: 30 },
  { name: "Charlie", age: 35 }
]);

3.2 查询文档

• 基本查询：

  // 精确匹配
  db.users.find({ name: "Alice" });
  // 条件查询（>、<、in等）
  db.users.find({ age: { $gt: 25 } });

• 投影：仅返回指定字段：

  db.users.find({}, { name: 1, _id: 0 });

3.3 更新与删除

• 更新操作：

  // 替换整个文档
  db.users.replaceOne({ name: "Alice" }, { name: "Alice", age: 26 });
  // 局部更新（推荐）
  db.users.updateOne(
    { name: "Alice" },
    { $set: { age: 26 } }
  );

• 删除操作：

  // 删除单个文档
  db.users.deleteOne({ name: "Alice" });
  // 删除所有匹配文档
  db.users.deleteMany({ age: { $lt: 30 } });

四、索引优化：提升查询性能

4.1 单字段索引

为高频查询字段创建索引：

db.users.createIndex({ name: 1 });  // 1表示升序，-1表示降序

4.2 复合索引

优化多字段查询：

db.users.createIndex({ age: 1, name: 1 });

索引设计原则：

• 选择性高：优先为区分度高的字段建索引（如用户ID）。
• 查询模式匹配：索引顺序应与查询条件顺序一致。

4.3 索引使用分析

通过explain()分析查询执行计划：

db.users.find({ age: 30 }).explain("executionStats");

关注executionStats.totalDocsExamined字段，若值远大于返回文档数，说明索引未生效。

五、聚合框架：复杂数据分析

MongoDB的聚合管道（Aggregation Pipeline）支持多阶段数据处理：

db.orders.aggregate([
  { $match: { status: "completed" } },  // 过滤
  { $group: { _id: "$customerId", total: { $sum: "$amount" } } },  // 分组统计
  { $sort: { total: -1 } },  // 排序
  { $limit: 10 }  // 限制结果数
]);

常用聚合操作符：

• $project：重命名字段或计算新字段。
• $lookup：关联其他集合（类似SQL的JOIN）。
• $unwind：展开数组字段。

六、事务与复制集：高可用保障

6.1 多文档事务

MongoDB 4.0+支持跨文档事务：

const session = db.getMongo().startSession();
session.startTransaction();
try {
  db.accounts.updateOne(
    { _id: "A" },
    { $inc: { balance: -100 } },
    { session }
  );
  db.accounts.updateOne(
    { _id: "B" },
    { $inc: { balance: 100 } },
    { session }
  );
  session.commitTransaction();
} catch (error) {
  session.abortTransaction();
}

适用场景：金融交易、库存扣减等需要原子性的操作。

6.2 复制集部署

复制集（Replica Set）提供自动故障转移：

# mongod.conf配置示例
replication:
  replSetName: "rs0"

初始化复制集：

rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "mongo1:27017" },
    { _id: 1, host: "mongo2:27017" },
    { _id: 2, host: "mongo3:27017", arbiterOnly: true }  // 仲裁节点
  ]
});

七、最佳实践与常见问题

7.1 性能优化建议

• 批量操作：使用bulkWrite()减少网络往返。
• 连接池管理：驱动端配置合理的连接池大小（如Node.js的maxPoolSize: 100）。
• 定期维护：运行compact命令回收碎片空间。

7.2 常见错误处理

• 写入超时：检查网络延迟或副本集同步状态。
• 索引过大：使用collStats监控索引大小，必要时重建索引。

总结

MongoDB的基本使用涵盖从环境搭建到高级查询的完整流程。通过合理设计数据模型、优化索引和聚合查询，开发者可以充分发挥其灵活性和扩展性优势。建议结合官方文档（docs.mongodb.com）和实际业务场景持续实践，逐步掌握MongoDB的核心能力。