Debian 系统上 MongoDB 升级注意事项
一 升级前准备
- 完整备份与可回滚方案：使用 mongodump 对业务库做全量备份，保留可回滚的 配置与密钥，并准备回滚包（前一稳定版 mongodb-org 组件）。升级窗口选在低峰时段，并确保有回滚时间。
- 版本与兼容性核对：确认当前 MongoDB 版本 与目标版本，评估 Debian 版本 与 MongoDB 版本 的适配；同时核对 驱动/连接器版本 与新服务器的兼容性，必要时先行升级驱动。
- 变更评估与测试：梳理新版本的不兼容变更与废弃特性，在测试环境完成升级演练与业务回归，确认应用连接、认证、特性使用均正常。
- 资源与容量：预留磁盘与 I/O，确保 dbPath 所在磁盘充足；检查 WiredTiger 缓存 与内存配置，避免 OOM。
- 高可用与维护：如为 副本集/分片集群，规划滚动升级顺序，逐个节点维护，保持大多数节点可用；准备好维护页面/告警与回滚预案。
二 仓库与版本选择
- 使用 MongoDB 官方 APT 仓库，避免混用不同来源的包；导入对应版本的 GPG 公钥，创建形如 /etc/apt/sources.list.d/mongodb-org-.list 的源文件。
- 选择与 Debian 代号匹配的仓库路径（如 bullseye），并为 amd64/arm64 正确声明架构；避免误用 Ubuntu 的路径导致依赖异常。
- 明确升级路径：同系列内小版本可直接升级；跨大版本（如 4.4 → 5.0 → 6.0）建议逐级升级，每一步都完成验证再继续。
- 指定版本安装（推荐）：使用带版本号的安装命令，确保各组件版本一致，例如：
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。
三 升级过程控制
- 单节点或测试环境：先停写（应用侧或维护模式），执行 sudo apt-get update 与升级命令，再 重启 mongod 并观察日志与状态。
- 副本集/分片集群：按“从 secondary 到 primary、逐个维护”的顺序执行，利用 rs.stepDown() 配合维护窗口完成主从切换；分片集群先升级 config server，再升级 shard，最后 mongos。
- 避免跨大版本直接替换二进制：不要跨多个主版本一次性替换包；每一步升级后执行 版本校验 与 基本健康检查（连接、复制、关键业务查询）。
- 服务与权限：使用 systemctl 管理 mongod，确保服务具备正确的启动用户与权限；升级后第一时间检查 服务状态 与 错误日志。
四 升级后验证与回滚
- 版本与服务：执行 mongod --version 与 mongo --eval ‘db.version()’ 校验版本；使用 systemctl status mongod 与 journalctl -u mongod 检查启动与运行日志。
- 复制与数据：在副本集执行 rs.status() 检查 optime/health；抽样查询与聚合验证数据一致性与性能；必要时使用 mongorestore 从备份快速恢复。
- 应用侧回归：回归核心链路与特性（认证、鉴权、事务、索引、变更流等），确认驱动与中间件兼容新版本行为。
- 回滚策略：若出现异常，优先回滚到前一稳定版本的 mongodb-org 组件包并重启；从备份 mongorestore 恢复关键数据，再按问题定位逐步升级。
五 常见坑与安全建议
- 架构与仓库不匹配：确保 Debian 代号 与 仓库路径一致，且 arch=amd64,arm64 与实际硬件匹配，避免依赖解析失败。
- 组件版本不一致：避免只升级其中部分组件（如仅 server），建议一次性对齐 mongodb-org-server/shell/mongos/tools 的版本号。
- 直接 purge 旧包：不要随意执行 apt-get remove --purge mongodb-org*，这会删除数据与配置；升级时优先使用 –only-upgrade 或指定版本安装。
- 忽略驱动兼容性：升级后若应用报错，优先检查 驱动/连接器 是否支持新服务器版本，必要时同步升级驱动。
- 安全加固：升级完成后复核 /etc/mongod.conf 的 security.authorization、网络绑定、TLS 配置与审计策略，确保最小权限与加密传输。