在 Ubuntu 上升级 MongoDB 的正确做法
一 升级前准备
- 明确目标版本与路径：跨大版本升级（如 4.4 → 5.0 → 6.0 → 7.0）通常要求按序进行，不能跨多代直接升级；先查阅对应版本的官方升级说明与兼容性矩阵。
- 完整备份：使用 mongodump 全量备份，确保可回滚。示例：mongodump --out /path/to/backup_$(date +%F)。
- 检查运行状态与复制集/分片拓扑：记录 MongoDB 版本、存储引擎（如 WiredTiger）、是否为 副本集/分片，以及应用连接串。
- 维护窗口与回滚预案：选择低峰期，准备回滚到旧版本的安装包与备份。
- 驱动与应用侧准备：升级后首次连接可能触发特性/行为变化，先在测试环境验证。
以上为通用且必要的准备动作，备份与有序升级能显著降低风险。
二 就地升级 MongoDB 软件包（同版本系列内）
- 步骤概览：
- 备份数据与检查版本：mongodump；mongod --version。
- 导入官方 GPG 密钥（若尚未导入）：wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -（示例为 6.0 系列密钥，其他系列请替换为对应密钥）。
- 配置正确的 APT 源（将 <UBUNTU_CODENAME> 替换为你的系统代号，如 focal、jammy）：
echo “deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu <UBUNTU_CODENAME>/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 --only-upgrade mongodb-org。
- 重启服务：sudo systemctl restart mongod。
- 验证：mongod --version；必要时连接 shell 执行 db.version()。
- 指定精确版本（可选）：
sudo apt-get install -y mongodb-org=6.0.0 mongodb-org-server=6.0.0 mongodb-org-shell=6.0.0 mongodb-org-mongos=6.0.0 mongodb-org-tools=6.0.0
- 说明：上述示例以 Ubuntu 20.04 Focal + MongoDB 6.0 为例，其他版本请替换代号与版本号；升级完成后务必做功能与数据校验。
三 跨大版本升级与兼容性要点
- 按代升级：遵循官方支持路径（如 4.4 → 5.0 → 6.0 → 7.0），每一步完成后再评估与测试，再进入下一步。
- 数据库工具版本匹配：确保 mongodump/mongorestore/mongoexport 等工具与服务器版本匹配，避免导入导出异常。
- 驱动与语言生态：升级服务器后，MongoDB PHP 扩展 等驱动也需对应升级并回归测试。
- 配置与特性变更：部分版本对默认参数、特性开关、命令行为有调整，升级后核对关键配置与业务行为。
这些要点能有效避免因版本不匹配或特性变更带来的兼容性问题。
四 升级失败回滚与常见问题排查
- 快速回滚：
- 停止服务：sudo systemctl stop mongod。
- 指定旧版本重装：sudo apt-get install mongodb-org=<OLD_VERSION> …（各组件一一对应）。
- 启动并验证：sudo systemctl start mongod；mongod --version。
- 如有备份，使用 mongorestore 恢复。
- 启动失败/闪退排查：
- 检查配置文件 /etc/mongod.conf 关键项（如 storage.dbPath、systemLog.path、net.bindIp）与目录权限。
- 查看日志定位错误：tail -n50 /var/log/mongodb/mongod.log。
- 资源与兼容性：确认磁盘/内存充足，MongoDB 与操作系统、驱动版本兼容。
- 数据损坏修复（谨慎）：mongod --repair --dbpath /var/lib/mongodb（仅在必要时执行）。
以上回滚与排查路径覆盖了常见的配置、资源、兼容性与数据损坏场景。