MongoDB在Debian中的数据恢复

MongoDB 在 Debian 的数据恢复指南

一、恢复前准备

• 确认备份类型与完整性：区分是逻辑备份（由 mongodump 生成，目录中包含 .bson 与 metadata.json）还是物理备份（数据文件直接拷贝）。逻辑备份用 mongorestore 恢复；物理恢复需保持文件权限与路径一致，通常需停库操作。
• 准备环境与权限：安装客户端工具（如未安装，执行：sudo apt update && sudo apt install mongodb-clients）；确保用于恢复的 Linux 用户对备份目录与目标数据目录具备读写权限；如使用认证，准备好用户名、密码与认证库（常见为 admin）。
• 选择恢复策略：全量恢复、按数据库/集合恢复、或基于 oplog 的时间点恢复（仅当备份包含 oplog 时可行）。
• 保护现网数据：恢复前先对当前实例做一份快照或导出关键数据，避免不可逆覆盖。

二、标准恢复步骤（逻辑备份）

• 停止写操作（强烈建议）：为减少一致性风险，先停止应用写入；如使用副本集，可将待恢复节点从隐藏/投票节点中临时移除，避免误选为主。
• 安装工具（如缺失）：sudo apt update && sudo apt install mongodb-clients。
• 执行恢复：
  • 全量恢复到当前实例：
    • 目录结构为 /path/to/backup/dump/ 时：
      • mongorestore /path/to/backup/dump
    • 若备份目录为自定义目录（不含 dump 子目录），可指定目标库：
      • mongorestore --db your_db /path/to/backup/your_db
  • 按数据库/集合恢复：
    • mongorestore --db your_db /path/to/backup/your_db
    • mongorestore --db your_db --collection your_coll /path/to/backup/your_db/your_coll.bson
  • 含 oplog 的时间点恢复（备份目录中包含 oplog.bson 时）：
    • mongorestore --oplogReplay /path/to/backup/
• 启动服务并验证：
  • 启动：sudo systemctl start mongod
  • 验证：用 mongo/mongosh 连接实例，检查集合计数、索引与样本数据。

三、物理文件恢复（文件系统级拷贝）

• 适用场景：已有 /var/lib/mongodb（WiredTiger 默认）或配置文件中 storage.dbPath 指定目录的完整物理备份。
• 操作步骤：
  • 停止服务：sudo systemctl stop mongod
  • 备份当前数据目录（可选但强烈建议）：sudo mv /var/lib/mongodb /var/lib/mongodb.bak_$(date +%F_%T)
  • 恢复数据文件：将备份的 dbPath 内容拷回（保持文件属主/权限与 SELinux/AppArmor 上下文一致，常见属主为 mongodb:mongodb）：
    • sudo cp -a /path/to/backup/mongodb /var/lib/
    • sudo chown -R mongodb:mongodb /var/lib/mongodb
  • 启动服务：sudo systemctl start mongod
  • 验证：连接实例检查数据一致性与复制状态（如启用副本集）。

四、常见问题与排查

• 权限错误：确保备份与数据目录对 mongodb 用户可读写（如：sudo chown -R mongodb:mongodb /var/lib/mongodb /path/to/backup）。
• 认证失败：使用 –username/–password/–authenticationDatabase admin 指定凭据；确认用户具备对目标库的readWrite或restore权限。
• 目标库已存在：默认会插入/创建；如希望清空后导入，可在恢复命令中加入 –drop（谨慎使用）。
• 恢复速度慢/占用高：大数据量时建议分批恢复、在低峰期执行，并监控系统 I/O 与内存；必要时使用压缩与限速策略。
• oplog 回放失败：确认备份确实包含 oplog.bson 且时间窗口覆盖故障点；仅适用于副本集/分片集群的 oplog 备份。

五、最佳实践

• 定期做逻辑备份（如每日），并保留多份历史；关键业务建议同时保留物理备份。
• 将备份脚本纳入 crontab（示例：每日 02:00 执行），并配合校验与异地/离线存储：
  • 0 2 * * * /usr/bin/mongodump --out /backup/mongodb/$(date +%Y%m%d%H%M%S)
• 恢复演练：定期在非生产环境验证备份的可用性与恢复流程。
• 监控与告警：对备份成功率、恢复耗时、磁盘空间建立监控与告警。