在 Debian 上执行 MongoDB 数据迁移的实用步骤
一 准备与版本选择
- 在 Debian 上安装 MongoDB 工具包（包含 mongodump/mongorestore）：sudo apt update && sudo apt install -y mongodb-clients。如使用较新功能或目标为 MongoDB Atlas，建议安装 MongoDB Database Tools ≥ 100.10.0，可用官方 .deb 包安装并验证版本：mongodump --version。为降低风险，先在测试环境演练，再在生产环境执行。若源/目标版本不同，务必确认兼容性；跨版本迁移时优先选择逻辑迁移（dump/restore）。
二 全量迁移步骤（mongodump → 传输 → mongorestore）
- 源端导出（示例为带认证的本地库）：mongodump --host localhost --port 27017 --username myUser --password myPass --authenticationDatabase admin --db myDatabase --out /backup/mongodb/$(date +%Y%m%d%H%M%S)。如需导出全库可省略 --db 参数。
- 传输到 Debian：scp -r /backup/mongodb/2025* user@debian:/backup/mongodb/ 或 rsync -av /backup/mongodb/ user@debian:/backup/mongodb/。
- Debian 端导入（示例恢复到同名库）：mongorestore /backup/mongodb/2025*/myDatabase。也可按库导入：mongorestore --db myDatabase /backup/mongodb/2025*/myDatabase；按集合导入：mongorestore --db myDatabase --collection coll /backup/mongodb/2025*/myDatabase/coll.bson。
- 验证：mongo --db myDatabase --quiet --eval ‘db.getCollectionNames()’ 查看集合是否齐全，并抽样查询校验数据一致性与数量。
三 其它常见场景
- 使用 JSON/CSV 在 Debian 间迁移少量数据：导出集合为 JSON/CSV（mongoexport），在 Debian 上用 mongoimport 导入；适合跨系统或结构转换场景。示例：mongoexport --uri=“mongodb://src:27017/db” --collection=c1 --out=c1.json；mongoimport --uri=“mongodb://debian:27017/db” --collection=c1 --file=c1.json。
- 迁移到 MongoDB Atlas：可使用 Atlas 的实时迁移（拉取/推送）或自助工具。若用 mongodump/mongorestore 自助迁移，请确保工具版本 ≥ 100.10.0，并按 Atlas 指引导入到目标集群。
- 不停机或跨版本/跨集群的增量迁移：可考虑第三方工具（如 MongoShake、DBMotion）或基于 Change Streams 自研同步；若源为副本集，也可结合 oplog 做时间点恢复（需具备相应权限与备份策略）。
四 注意事项与常见问题
- 版本与兼容性：目标库版本应支持源库的数据结构与特性；跨大版本升级时，优先逻辑迁移并充分回归测试。
- 性能与影响：mongodump 会对实例产生一定负载，建议在低峰期执行；大数据量可分库/分集合并行，或使用更细粒度的导出策略。
- 网络与权限：确保 Debian 能访问源端（开放 27017 或相应端口），并使用具备相应角色（如 read、readWrite、backup）的账户进行导出/导入。
- 一致性校验：迁移后对比集合计数、索引与抽样文档；如涉及分片集群，需确保分片键一致并按需重新分片。
- 配置差异：目标端 /etc/mongod.conf（如端口、数据目录、认证机制）应与应用期望一致，必要时调整后再导入。