MongoDB 3.2升级至5.0.2后mongodump报listIndexes解析错误如何解决

• 跨大版本升级未逐步设置特性兼容版本（FCV）：MongoDB从3.2到5.0跨越了多个大版本，升级过程中如果没有在每个版本升级完成后执行setFeatureCompatibilityVersion命令逐步升级FCV，会残留旧版本格式的索引元数据，5.0版本的mongodump无法识别这类旧格式条目。
• 索引元数据不兼容：3.2版本中存在的部分旧类型索引（如旧格式文本索引、带废弃属性的geo索引）没有在升级过程中自动转换为5.0兼容的格式，导致listIndexes接口读取元数据失败。
• 工具版本不匹配：使用的mongodump工具版本与MongoDB服务端5.0.2版本不一致，低版本工具无法解析高版本服务端返回的元数据结构。

步骤1：确认工具与服务端版本匹配 #

首先执行以下命令检查版本一致性：

# 检查mongodump版本
mongodump --version
# 检查MongoDB服务端版本
mongo --authenticationDatabase admin -u test123 -p pwd123 --eval "db.version()"

如果两者版本不一致，替换为与服务端同版本的mongodump工具后重试备份。

步骤2：修正特性兼容版本（FCV） #

登录Mongo shell执行以下命令查看当前FCV：

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

如果返回的FCV版本不是5.0，需先确保之前所有大版本升级都已完成对应FCV设置（不能跨版本设置，例如需先设到4.4再升级到5.0），再执行以下命令升级FCV到5.0：

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

命令返回ok后再尝试执行mongodump备份。

步骤3：排查并修复不兼容索引 #

如果设置FCV后仍报错，执行以下脚本定位存在不兼容元数据的集合：

use testdb
db.getCollectionNames().forEach(function(coll) {
  try {
    db[coll].getIndexes()
  } catch(e) {
    print("异常集合：" + coll, "错误信息：" + e)
  }
})

定位到异常集合后，删除该集合下的旧索引后重建：

# 删除旧索引，替换为实际的索引名
db.异常集合名.dropIndex("索引名")
# 按业务需求重新创建索引
db.异常集合名.createIndex({索引字段: 1})

完成索引重建后再执行备份即可。

应急备份方案 #

如果需要紧急备份无需先修复元数据，可以使用3.2版本的mongodump工具连接实例导出全量数据，再将导出的数据导入到全新的5.0.2实例中完成元数据自动转换，之后即可正常使用5.0版本的mongodump备份。

内容的提问来源于stack exchange，提问作者abbas-ak