Debian系统中MongoDB升级操作步骤详解

一 升级前准备

• 备份数据：建议先使用 mongodump 进行全量备份，确保 MongoDB 升级失败时能够快速回滚。示例：mongodump --out /path/to/backup-$(date +%F)。
• 检查现状：确认当前 MongoDB 版本、服务运行状态及基础环境是否正常。示例：mongod --version、systemctl status mongod。
• 查阅版本路径：MongoDB 官方通常基于 Ubuntu LTS 代号提供 APT 仓库（如 focal），在 Debian 系统中很多情况下也会沿用这些代号；实际操作时请以目标版本的官方文档为准，选择正确的仓库地址与版本系列。
• 规划维护窗口：建议在业务访问低峰期执行 Debian 下的 MongoDB 升级，并提前通知相关人员，降低升级带来的影响。

二、通过APT就地升级（强烈推荐）

• 更新索引并查看可用版本：
  • sudo apt-get update
  • apt-cache madison mongodb-org（用于确认当前可升级到的具体 MongoDB 版本）
• 执行升级（保持现有配置与数据目录不变）：
  • 升级到仓库中的最新版本：sudo apt-get install -y mongodb-org
  • 或按需指定组件与版本：sudo apt-get install -y mongodb-org-server=6.0.15 mongodb-org-shell=6.0.15 mongodb-org-mongos=6.0.15 mongodb-org-tools=6.0.15
• 重启并验证：
  • sudo systemctl restart mongod
  • mongod --version、systemctl status mongod
  • 连接 shell 再次确认：mongo --eval 'db.version()'（如果旧版 shell 仍在使用，也可以改用 mongosh）

三 跨大版本或遇到冲突时的做法

• 方式 A（保留数据与配置，优先尝试）：
  • 先备份：mongodump --out /path/to/backup-$(date +%F)
  • 仅移除软件包但保留数据：sudo apt-get purge -y mongodb-org*（注意该操作不会删除 /var/lib/mongodb 与 /etc/mongod.conf）
  • 按目标 MongoDB 版本重新导入正确的 GPG 公钥 与 APT 源（可参考下一节示例），然后执行 sudo apt-get update && sudo apt-get install -y mongodb-org
  • 重启并验证：sudo systemctl restart mongod、mongod --version
• 方式 B（全新安装，最干净）：
  • 完成备份后彻底清理：sudo apt-get purge -y mongodb-org* 并手动清理 /var/lib/mongodb、/var/log/mongodb（请谨慎执行）
  • 按目标版本重新配置仓库并安装：sudo apt-get install -y mongodb-org
  • 使用原有 /etc/mongod.conf 启动服务：sudo systemctl start mongod
  • 如需执行回滚，先停止数据库服务，再运行 mongorestore /path/to/backup

四 仓库与密钥配置示例

• 导入公钥（以目标版本使用的密钥为准，以下示例为 server-6.0.asc）：
  • wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
• 添加 APT 源（Debian 系统中通常会沿用 Ubuntu LTS 代号；以下为常见配置示例，请根据目标版本和系统架构灵活调整）：
  • Debian 11（Bullseye）示例：
    • echo "deb [arch=amd64,arm64] https://repo.mongodb.org/apt/debian bullseye/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
  • 若官方文档要求使用 Ubuntu 代号（如 focal）：
    • echo "deb [arch=amd64,arm64] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
• 更新索引并安装 MongoDB：sudo apt-get update && sudo apt-get install -y mongodb-org

五 升级后验证与回滚

• 功能与版本验证：
  • mongod --version、systemctl status mongod
  • 连接数据库进行复核：mongo --eval 'db.version()'（或使用 mongosh）
  • 检查系统日志：sudo journalctl -u mongod -b，确认没有启动报错、兼容性警告或数据文件异常提示
• 回滚方案：
  • 使用升级前生成的 mongodump 备份执行恢复：mongorestore /path/to/backup-
  • 如果采用的是“全新安装”方案，可快速切换回旧版本软件包，并恢复原有配置和数据目录后重新启动服务

六 集群与注意事项

• 副本集/分片集群：建议逐节点进行 MongoDB 升级，严格遵循官方支持的升级顺序；通常先升级 Secondary，再处理 Primary，而分片架构中的 mongos 与 config server 也应按计划滚动升级，确保各节点版本一致后再进入下一步。
• 版本路径与兼容性：在跨多个大版本升级前，务必仔细阅读目标版本的 Release Notes、升级说明与兼容性要求，必要时先在测试环境中演练完整流程。
• 配置与存储：MongoDB 升级通常不会自动修改 /etc/mongod.conf 与 /var/lib/mongodb；如果存储引擎、参数配置或安全策略发生变化，需要依据官方指导完成调整后再启动服务。
• 安全建议：整个升级过程应建立在备份完整、监控正常、回滚路径明确的前提下进行，确保在维护窗口内可随时恢复业务。