Linux环境下MongoDB版本升级指南

一、升级前的准备工作

1. 备份数据

升级前必须备份所有数据库，防止操作失误或异常导致数据丢失。推荐使用mongodump工具全量备份：

mongodump --out /path/to/backup_dir  # 指定备份输出目录

备份完成后，验证备份文件的完整性（可通过mongorestore --dryRun模拟恢复）。

2. 检查当前版本与升级路径

通过以下命令确认当前MongoDB版本：

mongod --version  # 或 mongo --eval 'db.version()'

查阅MongoDB官方升级文档，确认支持的升级路径（如3.4→3.6→4.0→4.2→4.4→5.0→6.0→7.0→8.0）。禁止跨内核版本直接升级（例如3.4不能直接升级到4.0，需逐步升级）。

3. 阅读新版本发布说明

关注新版本的变更内容（如默认配置调整、废弃功能、性能优化）、兼容性要求（如存储引擎、驱动版本）及已知问题，确保应用与新版本兼容。

二、具体升级步骤（以社区版为例）

1. 停止MongoDB服务

根据系统初始化工具选择对应命令：

• Systemd系统（如Ubuntu 16.04+、CentOS 7+）：

  sudo systemctl stop mongod
  

• SysVinit系统（如Ubuntu 14.04、CentOS 6）：

  sudo service mongod stop
  

2. 下载并安装新版本

方式一：通过包管理器升级（推荐）

若已通过官方仓库安装，可直接更新包：

# Ubuntu/Debian
sudo apt update
sudo apt install --only-upgrade mongodb-org

# CentOS/RHEL
sudo yum update mongodb-org

方式二：手动下载安装包

1. 访问MongoDB官方下载页面，选择对应Linux发行版的安装包（如.tgz格式）；
2. 解压并复制到目标目录：

   wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-6.0.5.tgz  # 示例链接
   tar -zxvf mongodb-linux-x86_64-rhel80-6.0.5.tgz
   sudo mv mongodb-linux-x86_64-rhel80-6.0.5 /usr/local/mongodb
   

3. 创建符号链接（可选）：

   sudo ln -s /usr/local/mongodb/bin/mongod /usr/bin/mongod
   sudo ln -s /usr/local/mongodb/bin/mongo /usr/bin/mongo
   

3. 更新配置文件

编辑MongoDB配置文件（通常位于/etc/mongod.conf），根据新版本要求调整参数：

• 存储路径：确认storage.dbPath指向正确的数据目录；
• 日志路径：确认systemLog.path指向正确的日志文件；
• 绑定IP：若需远程访问，调整net.bindIp（如0.0.0.0）；
• 认证设置：若启用认证，确保security.authorization设置为enabled；
• 功能兼容性版本（FCV）：若升级跨度较大，可能需要设置featureCompatibilityVersion（如从4.4升级到5.0，需设置为"5.0"）。

4. 启动新版本服务

# Systemd系统
sudo systemctl start mongod

# SysVinit系统
sudo service mongod start

检查服务状态，确保启动成功：

sudo systemctl status mongod  # 或 sudo service mongod status

5. 验证升级结果

连接到MongoDB Shell，检查版本信息：

mongo --eval 'db.version()'  # 应输出新版本号

或使用mongosh（MongoDB Shell的新版本）：

mongosh --eval 'db.version()'

三、升级注意事项

1. 版本兼容性

• 存储引擎：从MMAPv1升级到WiredTiger时，需提前转换数据文件（WiredTiger为MongoDB 3.2+的默认存储引擎）；
• 驱动兼容：确保应用程序使用的MongoDB驱动支持新版本（参考驱动官方文档）。

2. 功能兼容性版本（FCV）

• 大版本升级后，需通过以下命令设置FCV，确保应用与新版本兼容：

  use admin
  db.adminCommand({setFeatureCompatibilityVersion: "新版本号"})  // 如"6.0"
  

• FCV设置后需重启MongoDB生效。

3. 回滚准备

• 升级前记录当前版本、配置文件及数据目录路径；
• 若升级失败，可通过备份恢复数据，并回退到旧版本：

  # 卸载新版本
  sudo apt remove mongodb-org  # 或 sudo yum remove mongodb-org
  # 重新安装旧版本
  sudo apt install mongodb-org=旧版本号  # 或 sudo yum install mongodb-org=旧版本号
  

4. 监控与测试

• 升级后监控数据库性能（如CPU、内存、磁盘IO）、日志（检查mongod.log是否有错误）；
• 在测试环境验证应用功能，确保读写操作正常。

四、常见问题解决

1. 升级后无法启动

• 检查配置文件语法（mongod --config /etc/mongod.conf --fork --logpath /var/log/mongod.log）；
• 查看日志文件（tail -f /var/log/mongod.log），定位错误原因（如权限问题、路径错误）。

2. 数据不一致

• 若升级后数据异常，尝试从备份恢复（mongorestore /path/to/backup_dir）；
• 确认升级前数据备份的完整性。

3. 驱动不兼容

• 升级驱动至最新版本（参考MongoDB驱动官方文档）；
• 测试应用与驱动的兼容性。