Ubuntu环境下MongoDB故障恢复指南

一、故障排查前置步骤

在启动恢复流程前，需先通过以下步骤定位故障根源，避免盲目操作：

1. 查看服务状态：使用sudo systemctl status mongod（或sudo service mongod status）检查MongoDB服务是否运行。若未运行，需进一步排查原因。
2. 分析错误日志：MongoDB的默认日志路径为/var/log/mongodb/mongod.log，使用sudo tail -n 100 /var/log/mongodb/mongod.log查看最近100条日志，重点关注“ERROR”“FAILED”等关键词，定位具体故障类型（如配置错误、权限问题、数据损坏）。
3. 检查配置文件：确认/etc/mongod.conf配置文件的正确性，重点检查以下关键项：
   • storage.dbPath：数据目录是否存在且路径正确；
   • net.bindIp：绑定的IP地址是否符合需求（如0.0.0.0允许远程访问）；
   • systemLog.path：日志文件路径是否可写。
4. 验证端口占用：MongoDB默认使用27017端口，使用sudo lsof -i :27017或sudo netstat -tulpn | grep 27017检查端口是否被其他进程占用。若被占用，终止占用进程（sudo kill <PID>）或修改配置文件中的端口。
5. 检查权限设置：MongoDB服务通常以mongodb用户运行，需确保数据目录（如/var/lib/mongodb）和日志文件的权限正确。使用sudo chown -R mongodb:mongodb /var/lib/mongodb修改数据目录所有者，使用sudo chmod -R 755 /var/lib/mongodb设置合理权限。

二、常见故障及解决方法

1. 无法启动MongoDB服务

• 原因：日志中常见“Failed to start mongod.service”“Unit mongod.service is not loaded properly”等错误。
• 解决方法：
  • 编辑systemd服务文件：sudo vim /etc/systemd/system/mongodb.service（若未创建，可复制默认配置），确保ExecStart指向正确路径（如ExecStart=/usr/bin/mongod --quiet --config /etc/mongod.conf）；
  • 重新加载systemd配置并启动服务：sudo systemctl daemon-reload → sudo systemctl start mongod。

2. 连接被拒绝

• 原因：日志中常见“Connection refused”，多为服务未启动、端口被占用或数据目录锁文件未清除。
• 解决方法：
  • 启动服务：sudo systemctl start mongod；
  • 若仍无法连接，删除数据目录中的锁文件（sudo rm /var/lib/mongodb/mongod.lock），并以修复模式启动MongoDB：sudo mongod --repair --dbpath /var/lib/mongodb；
  • 修复完成后，重启服务：sudo systemctl start mongod。

3. 数据文件损坏

• 原因：突然断电、磁盘故障或强制终止服务可能导致数据文件损坏，日志中常见“InvalidBSON”“repair needed”等错误。
• 解决方法：
  • 停止MongoDB服务：sudo systemctl stop mongod；
  • 执行修复命令：sudo mongod --repair --dbpath /var/lib/mongodb（修复过程可能需要较长时间，取决于数据量）；
  • 修复完成后，重启服务：sudo systemctl start mongod。
  • 注意：修复前建议备份数据目录（sudo cp -r /var/lib/mongodb /var/lib/mongodb_backup），避免修复失败导致数据丢失。

4. 权限问题

• 原因：数据目录或日志文件的所有者不是mongodb用户，日志中常见“Permission denied”。
• 解决方法：
  • 修改数据目录所有者：sudo chown -R mongodb:mongodb /var/lib/mongodb；
  • 修改日志文件所有者（若日志路径为/var/log/mongodb/mongod.log）：sudo chown mongodb:mongodb /var/log/mongodb/mongod.log；
  • 重启服务：sudo systemctl start mongod。

三、数据恢复流程

若故障导致数据丢失，可通过以下方法恢复（需提前有备份）：

1. 逻辑备份与恢复（推荐）

• 备份：使用mongodump工具导出数据（支持全库、指定集合或查询结果）。例如，导出mydb数据库到/backup目录：mongodump --uri="mongodb://user:password@localhost:27017/mydb" --out=/backup。
• 恢复：使用mongorestore工具导入数据。例如，恢复mydb数据库：mongorestore --uri="mongodb://user:password@localhost:27017/mydb" /backup/mydb（若需覆盖现有数据，添加--drop参数）。

2. 物理备份与恢复

• 备份：停止MongoDB服务（sudo systemctl stop mongod），复制数据目录到备份路径（如/backup）：cp -r /var/lib/mongodb /backup。
• 恢复：停止服务，复制备份目录到数据目录（sudo cp -r /backup/mongodb /var/lib/），启动服务（sudo systemctl start mongod）。

3. Oplog恢复（精确到故障前状态）

• 前提：备份时启用了Oplog（默认开启），且备份目录中包含Oplog数据（位于dump/local/oplog.rs.bson）。
• 恢复步骤：
  • 使用mongorestore恢复全量备份：mongorestore --uri="mongodb://user:password@localhost:27017/" /backup；
  • 回放Oplog，恢复故障前的增量操作：mongorestore --uri="mongodb://user:password@localhost:27017/" --oplogReplay /backup。

4. 第三方工具恢复

若上述方法无效，可使用第三方工具（如MongoDB Compass、Robo 3T、EaseUS Data Recovery Wizard for MongoDB）尝试恢复。需注意：

• 工具需从官方渠道下载，避免恶意软件；
• 恢复前停止MongoDB服务，避免数据覆盖；
• 恢复成功率取决于数据损坏程度。

四、预防措施

1. 定期备份：制定备份策略（如每日全备+每小时增量备），将备份文件存储在异地（如云存储）；
2. 监控系统：使用mongostat（查看性能指标）、mongotop（查看集合读写情况）监控MongoDB状态，及时发现异常；
3. 测试恢复：定期测试备份文件的可用性（如在测试环境恢复备份），确保备份有效；
4. 高可用部署：使用复制集（Replica Set）或分片集群（Sharding），提高数据冗余和故障恢复能力。