使用官方MongoDB Docker镜像部署后，如何升级MongoDB？

先明确两个核心前提 #

1. MongoDB升级必须遵循小版本逐步递进的路径，比如从4.4升级到6.0，必须先升到5.0并完成兼容性检查，再升到6.0，不能跨大版本跳级。
2. 无论哪种方式，升级前备份数据都是不可省略的底线操作。

为什么不推荐你提到的两种方式 #

• exec进入容器内部升级：完全违背Docker的设计原则，容器是一次性运行单元，直接在容器内操作的升级结果无法持久化，重启容器后就会失效，且操作过程不透明，排查问题难度大。
• mongodump/mongorestore：虽然操作简单，但需要停机导出/导入数据，大数据量场景下耗时极长，生产环境会造成业务中断，属于兜底方案而非最优解。

更优升级方案：利用Docker卷+官方镜像的原生升级能力 #

官方MongoDB镜像支持直接挂载原有数据卷启动，启动时mongod会自动完成数据存储格式的升级（针对兼容的版本路径），根据部署模式分为两种场景：

1. 单节点部署（测试/非核心环境）

• 步骤1：停掉旧容器

  docker stop mongodb
  

• 步骤2：备份数据卷（关键）
  用临时容器打包数据卷到本地：

  docker run --rm -v mongodb-data:/data/db -v $(pwd)/mongodb-backup:/backup busybox tar cvf /backup/mongodb-full-backup.tar /data/db
  

• 步骤3：用新版本镜像启动容器
  挂载原有数据卷，指定新版本镜像：

  docker run -d --name mongodb -v mongodb-data:/data/db mongo:<目标版本号>
  

• 步骤4：验证升级结果
  查看容器日志确认升级完成：

  docker logs mongodb
  

  日志中出现Detected data files in /data/db created by MongoDB version X.X, requiring upgrade to Y.Y相关信息，且最终显示waiting for connections即为成功。

2. 副本集部署（生产环境推荐，零停机）

副本集可以通过滚动升级实现业务无中断：

• 步骤1：升级所有次要节点（Secondary）
  逐个停止次要节点容器，用新版本镜像重启，挂载原数据卷：

  # 停止旧次要节点
  docker stop mongodb-secondary-1
  # 用新版本重启
  docker run -d --name mongodb-secondary-1 -v mongodb-secondary-1-data:/data/db mongo:<目标版本号> --replSet rs0
  

  每个节点启动后，用以下命令确认同步完成：

  docker exec mongodb-secondary-1 mongo --eval "rs.status().members.find(m => m.name === 'mongodb-secondary-1:27017').stateStr"
  

  返回SECONDARY即为同步完成，再继续升级下一个次要节点。

• 步骤2：升级主节点（Primary）
  先将主节点降级为次要节点，避免强制停机导致数据不一致：

  docker exec mongodb-primary mongo --eval "rs.stepDown(600)"
  

  然后重复次要节点的升级步骤，停止旧主节点容器，用新版本镜像重启，等待节点重新加入副本集并完成同步。

• 步骤3：确认集群状态
  查看整个副本集的状态，确保所有节点都是目标版本且状态正常：

  docker exec mongodb-primary mongo --eval "rs.status()"
  

额外注意事项 #

• 升级前务必查看MongoDB官方文档的版本兼容性说明，确认当前版本到目标版本的升级条件（比如是否需要提前启用某些特性、废弃配置项）。
• 如果是跨大版本升级，比如4.4→5.0，升级完成后需要执行db.adminCommand({ setFeatureCompatibilityVersion: "5.0" })来启用新版本的特性。

内容的提问来源于stack exchange，提问作者Jiew Meng