MongoDB 文档数据库专题 on PlumePHP

11. MongoDB 安全认证与备份恢复

Fri, 14 Aug 2026 12:11:00 +0800

生产环境的 MongoDB 需要系统的安全加固，包括访问控制、网络加密、审计日志和数据备份策略。

1. RBAC 角色权限

1.1 创建用户与角色

// 启用认证后连接 admin 库
use admin;

db.createUser({
 user: "app_user",
 pwd: "secure_password",
 roles: [
 { role: "readWrite", db: "shop" }, // 读写 shop 库
 { role: "read", db: "analytics" } // 只读 analytics
 ]
});

// 自定义角色
db.createRole({
 role: "orderProcessor",
 privileges: [
 { resource: { db: "shop", collection: "orders" },
 actions: ["find", "insert", "update"] },
 { resource: { db: "shop", collection: "inventory" },
 actions: ["find", "update"] }
 ],
 roles: []
});

1.2 内置角色

角色	权限
`read`	读取所有非系统集合
`readWrite`	读写所有非系统集合
`dbAdmin`	管理索引、统计、验证规则
`userAdmin`	管理用户和角色
`dbOwner`	readWrite + dbAdmin + userAdmin
`clusterManager`	管理复制集/分片

2. TLS 加密

# mongod.conf
net:
 tls:
 mode: requireTLS
 certificateKeyFile: /etc/ssl/mongodb.pem
 CAFile: /etc/ssl/ca.pem
 allowConnectionsWithoutCertificates: false

# 客户端连接
mongo --tls --host mongo.example.com \
 --tlsCertificateKeyFile client.pem \
 --tlsCAFile ca.pem

3. 备份恢复

3.1 mongodump / mongorestore

# 备份（指定复制集）
mongodump --uri="mongodb://user:pass@rs0/mongo1:27017,mongo2:27017/shop?replicaSet=rs0" \
 --out=/backup/$(date +%Y%m%d)

# 恢复
mongorestore --uri="mongodb://user:pass@localhost/shop" \
 --dir=/backup/20240115/shop \
 --drop # 恢复前删除现有集合

3.2 文件系统快照（更快）

# 使用 LVM 或云盘快照
# 要求开启 journal 并使用 WiredTiger

# 1. 锁定写入（仅 secondary 或 standalone）
mongo --eval "db.fsyncLock()"

# 2. 创建快照
lvcreate --snapshot --size 10G --name mongo-snap /dev/vg0/mongo

# 3. 解锁
db.fsyncUnlock()

3.3 oplog 还原到时间点

# 基于 oplog 恢复到特定时间点
mongorestore --oplogReplay --oplogLimit "1705315200:1" /backup/

4. 备份策略

策略	RPO	RTO	适用
每日 mongodump	24h	小时级	中小数据量
hourly 增量 + 每日全量	1h	小时级	大数据量
文件系统快照	分钟级	分钟级	云环境
跨区复制集	秒级	分钟级	高可用要求

10. MongoDB 性能调优与运维监控

Fri, 14 Aug 2026 12:10:00 +0800

MongoDB 的性能取决于存储引擎、索引使用、查询模式和工作负载特征。系统的调优策略包括 Profiler 分析、explain 诊断、内存参数调整和操作系统层面的优化。

1. WiredTiger 存储引擎

1.1 缓存配置

# mongod.conf
storage:
 wiredTiger:
 engineConfig:
 cacheSizeGB: 4 # 默认 = (RAM - 1GB) / 2

// 运行时查看缓存状态
db.serverStatus().wiredTiger.cache
// {
// "bytes currently in the cache": 2147483648,
// "maximum bytes configured": 4294967296,
// "tracked dirty bytes in the cache": 10485760
// }

内存使用分配：

09. Spring Data MongoDB 实战

Fri, 14 Aug 2026 12:09:00 +0800

Spring Data MongoDB 是 Spring 生态中对 MongoDB 的官方支持，提供了 Repository 接口和 MongoTemplate 两种操作模式。本文覆盖配置、基础 CRUD、复杂查询、聚合与事务。

1. 配置

# application.yml
spring:
 data:
 mongodb:
 uri: mongodb://user:pass@mongo1:27017,mongo2:27017/mydatabase?replicaSet=rs0
 # 或:
 # host: localhost
 # port: 27017
 # database: mydatabase
 # username: user
 # password: pass

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>

2. 实体映射

@Document(collection = "products")
@CompoundIndex(name = "category_price", def = "{'category': 1, 'price': -1}")
public class Product {
 @Id
 private String id; // 映射 _id

 private String name;
 private String category;
 private BigDecimal price;
 private int stock;

 @Field("created_at")
 private Instant createdAt;

 @DBRef
 private Supplier supplier; // 引用（慎用，性能差）

 // 嵌套文档
 private List<Review> reviews;
}

public record Review(String userId, int rating, String comment, Instant date) {}

3. Repository 接口

public interface ProductRepository extends MongoRepository<Product, String> {

 // 自动派生查询
 List<Product> findByCategoryAndPriceLessThan(String category, BigDecimal price);

 // 模糊搜索（正则）
 List<Product> findByNameContainingIgnoreCase(String name);

 // 排序分页
 Page<Product> findByCategoryOrderByPriceDesc(String category, Pageable pageable);

 // @Query 自定义
 @Query("{ 'category': ?0, 'price': { $gte: ?1, $lte: ?2 } }")
 List<Product> findByPriceRange(String category, BigDecimal min, BigDecimal max);

 // 聚合统计
 @Aggregation(pipeline = {
 "{ $match: { category: ?0 } }",
 "{ $group: { _id: null, avgPrice: { $avg: '$price' }, totalStock: { $sum: '$stock' } } }"
 })
 ProductStats getStatsByCategory(String category);
}

4. MongoTemplate

@Service
public class ProductService {
 @Autowired private MongoTemplate mongoTemplate;

 public List<Product> search(String keyword, String category) {
 Query query = new Query();

 // 动态条件
 if (StringUtils.hasText(keyword)) {
 query.addCriteria(Criteria.where("name")
 .regex(keyword, "i"));
 }
 if (StringUtils.hasText(category)) {
 query.addCriteria(Criteria.where("category").is(category));
 }

 query.with(Sort.by(Sort.Direction.DESC, "createdAt"));
 query.limit(20);

 return mongoTemplate.find(query, Product.class);
 }

 // 批量更新
 public void updateStockBatch(Map<String, Integer> stockChanges) {
 BulkOperations bulkOps = mongoTemplate.bulkOps(
 BulkOperations.BulkMode.UNORDERED, Product.class);

 stockChanges.forEach((id, qty) -> {
 Query query = Query.query(Criteria.where("_id").is(id));
 Update update = new Update().inc("stock", qty);
 bulkOps.updateOne(query, update);
 });

 bulkOps.execute();
 }

 // 聚合管道
 public List<Document> getCategoryRevenue() {
 Aggregation agg = Aggregation.newAggregation(
 Aggregation.match(Criteria.where("status").is("completed")),
 Aggregation.unwind("items"),
 Aggregation.group("items.category")
 .sum(ArithmeticOperators.Multiply.valueOf("items.price")
 .multiplyBy("items.quantity")).as("revenue"),
 Aggregation.sort(Sort.Direction.DESC, "revenue")
 );

 return mongoTemplate.aggregate(agg, "orders", Document.class)
 .getMappedResults();
 }
}

5. 事务

@Service
public class OrderService {
 @Autowired private MongoTemplate mongoTemplate;
 @Autowired private MongoTransactionManager transactionManager;

 @Transactional
 public void createOrder(OrderRequest request) {
 // 扣减库存
 mongoTemplate.updateFirst(
 Query.query(Criteria.where("sku").is(request.sku())),
 new Update().inc("stock", -request.qty()),
 Product.class
 );

 // 创建订单
 Order order = new Order(request);
 mongoTemplate.save(order);
 }
}

08. MongoDB Change Streams 实时同步

Fri, 14 Aug 2026 12:08:00 +0800

Change Streams 是 MongoDB 3.6 引入的功能，允许应用实时监听集合（或整个数据库）的变更事件。它是构建事件驱动架构、数据同步、缓存失效等场景的核心工具。

1. 基本原理

应用层 MongoDB
 │ │
 ├─── watch("db.orders") ──────────→┤
 │ (建立长连接) │
 │ ←── 变更事件推送 ─────────────┤
 │ │
 │ 事件类型: insert / update / delete
 │ 包含: 完整文档/变更差异 + Namespace + clusterTime

Change Streams 基于 oplog，因此要求 MongoDB 以复制集或分片集群方式运行。

07. MongoDB 事务 ACID 支持

Fri, 14 Aug 2026 12:07:00 +0800

MongoDB 从 4.0 开始支持 replica set 级别的多文档事务，4.2 扩展到分片集群事务。虽然 MongoDB 的事务不如关系型数据库成熟，但在需要强一致性的场景下非常有用。

1. ACID 保证

ACID	MongoDB 支持	说明
Atomicity	✅	事务内所有操作同时成功或同时回滚
Consistency	✅	遵守文档验证规则和索引约束
Isolation	✅ Snapshot	快照隔离（Repeatable Read 级别）
Durability	✅（可配置）	journal 持久化

2. 事务基础用法

2.1 Mongo Shell

const session = db.getMongo().startSession();
session.startTransaction({
 readConcern: { level: "snapshot" },
 writeConcern: { w: "majority" }
});

try {
 const orders = session.getDatabase("shop").orders;
 const inventory = session.getDatabase("shop").inventory;

 // 扣减库存
 inventory.updateOne(
 { sku: "SKU001" },
 { $inc: { qty: -2 } },
 { session }
 );

 // 创建订单
 orders.insertOne({
 userId: "u123",
 items: [{ sku: "SKU001", qty: 2 }],
 status: "paid",
 createdAt: new Date()
 }, { session });

 session.commitTransaction();
} catch (error) {
 session.abortTransaction();
 throw error;
} finally {
 session.endSession();
}

2.2 驱动程序（Java）

MongoClient client = MongoClients.create("mongodb://localhost:27017");
ClientSession session = client.startSession();

TransactionOptions txnOptions = TransactionOptions.builder()
 .readConcern(ReadConcern.SNAPSHOT)
 .writeConcern(WriteConcern.MAJORITY)
 .readPreference(ReadPreference.primary())
 .build();

TransactionBody<String> txnBody = () -> {
 MongoDatabase db = client.getDatabase("shop");
 db.getCollection("inventory").updateOne(
 session, Filters.eq("sku", "SKU001"),
 Updates.inc("qty", -2)
 );
 db.getCollection("orders").insertOne(session,
 new Document("userId", "u123")
 .append("status", "paid")
 .append("createdAt", new Date())
 );
 return "Order created successfully";
};

try {
 String result = session.withTransaction(txnBody, txnOptions);
 System.out.println(result);
} catch (RuntimeException e) {
 // 事务自动回滚
 throw e;
} finally {
 session.close();
}

3. 事务限制

限制	说明
事务超时	默认 60 秒（maxTransactionLockRequestTimeoutMillis）
文档修改	事务内无法创建/删除集合和索引
操作数量	无硬性限制，但受 oplog 大小限制
分片事务	涉及多个分片时性能下降明显
会话	每个事务必须绑定一个会话

4. 性能影响

单文档写入: 50,000+ ops/s
多文档事务: 5,000-10,000 ops/s （事务开销约 5-10x）

事务延迟来源:
 - 获取快照（Snapshot）
 - 两阶段提交协调（分片事务）
 - oplog 同步

最佳实践：能用单文档原子操作（update + $inc 等）就不用事务。

06. MongoDB 分片集群架构设计

Fri, 14 Aug 2026 12:06:00 +0800

当单台 MongoDB 服务器的存储或写入能力达到瓶颈时，需要使用分片（Sharding）进行水平扩展。分片将数据分布在多个服务器上，每个分片是一个独立的复制集。

05. MongoDB 复制集与高可用架构

Fri, 14 Aug 2026 12:05:00 +0800

MongoDB 复制集（Replica Set）由一组 mongod 实例组成，提供数据冗余和高可用性。本文深入复制集的原理、配置和运维实践。

1. 复制集架构

 ┌─────────────────┐
 │ Primary │ ← 唯一可写，所有写操作通过这里
 │ (priority:1) │
 └────────┬────────┘
 │ 写入
 ┌────────┴────────┐
 │ │
┌───────▼───────┐ ┌────▼──────────┐
│ Secondary 1 │ │ Secondary 2 │ ← 只读，异步复制 oplog
│(priority:0.5) │ │(priority:0.5) │
└───────────────┘ └───────────────┘

可选: Arbiter（仲裁节点，无数据，只参与选举）

复制集规则：

04. MongoDB 聚合管道深度解析

Fri, 14 Aug 2026 12:04:00 +0800

聚合管道（Aggregation Pipeline）是 MongoDB 最强大的数据分析工具，通过将多个处理阶段串联，能够实现复杂的数据转换、分组统计和关联查询。相比 MapReduce，聚合管道更直观、性能更好。

03. MongoDB 索引类型与查询优化

Fri, 14 Aug 2026 12:03:00 +0800

索引是数据库性能的核心。MongoDB 使用 B-Tree 索引，与关系型数据库类似，但有一些独特之处——如多键索引（数组索引）、文本索引、TTL 索引等。理解索引原理并正确使用 Explain 进行分析，是 MongoDB 调优的关键。

02. MongoDB 文档模型设计：嵌套 vs 引用

Fri, 14 Aug 2026 12:02:00 +0800

MongoDB 的灵活性是其最大优势也是最大陷阱——没有固定的 schema 意味着可以自由设计，但也意味着设计不当会导致性能灾难。文档模型的核心决策是何时嵌套、何时引用。

01. MongoDB 核心概念与 CRUD 操作

Fri, 14 Aug 2026 12:01:00 +0800

MongoDB 是一个面向文档的 NoSQL 数据库，使用 BSON（Binary JSON）作为数据格式。相比传统关系型数据库的表-行结构，MongoDB 采用集合-文档的层次结构，更适合存储半结构化数据和快速迭代场景。

Go + MongoDB 驱动实战：连接池、事务与 Change Streams