mongorestore

恢复 MongoDB 逻辑备份

补充说明

mongorestore 读取 mongodump 产出的 BSON 或归档文件，把集合、索引和可选 oplog 回放到目标实例。它可以全量恢复，也可以按命名空间筛选。

常用示例

mongorestore --uri="mongodb://app@127.0.0.1:27017" /backup
mongorestore --uri="mongodb://app@db:27017" --gzip --archive=/backup/appdb.gz
mongorestore --uri="mongodb://app@db:27017" --nsInclude='appdb.orders' /backup
mongorestore --uri="mongodb://app@db:27017" --nsFrom='appdb.*' --nsTo='appdb_staging.*' /backup
mongorestore --uri="mongodb://app@db:27017" --drop /backup
mongorestore --uri="mongodb://app@db:27017" --oplogReplay /backup
mongorestore --uri="mongodb://app@db:27017" --dryRun /backup

易错点与排错

• --drop 会先删目标集合，属于破坏性操作；先恢复到临时库验证。
• --oplogReplay 要求备份时用了 --oplog，否则没有可回放的数据。
• 不指定数据库时按备份里的命名空间恢复；--nsInclude 语法要带库名。
• 恢复是合并而不是替换；同名文档会按 _id 覆盖或报重复键。
• 用户和角色默认不在备份里，需要单独恢复 admin 库。
• 恢复期间会重建索引，大集合耗时明显；可先 --noIndexRestore 再手工建。
• 跨大版本恢复先查兼容性；高版本备份恢复到低版本通常不行。
• 目标磁盘空间要按数据和索引总量预留，恢复过程还会产生临时文件。

相关命令

• mongodump — 生成 BSON 备份
• mongosh — 恢复后校验