centos上mongodb版本兼容性问题

CentOS 上 MongoDB 版本兼容性要点

一 系统与 CPU 架构约束

• CentOS 6.x：最高建议使用 MongoDB 4.4.x；自 4.2.24 起官方不再内置 mongorestore 等工具，需单独安装 MongoDB Database Tools；即便在 4.4 分支，CentOS 6.5 的可用上限通常为 4.4.23。
• CentOS 7.x：可稳定运行 4.4 系列；从 5.0 起要求 CPU 支持 AVX 指令集，部分老机型会因此无法启动或报非法指令错误。
• glibc 与工具链：选择与系统 glibc 版本匹配的官方构建包（如 rhel70 对应 CentOS 7），避免跨发行版二进制引发兼容性问题。
• 驱动与生态：驱动、O/S、库版本需与目标 MongoDB 版本匹配；跨大版本升级时，先小流量验证再全量切换。

二 存储引擎与特性兼容

• 默认存储引擎：自 3.2 起默认 WiredTiger；在 4.4 的配置中仍显式设置 engine: wiredTiger 属于常规做法。
• 事务支持：多文档事务在 4.0 引入，若应用依赖事务，请确保部署版本 ≥ 4.0。
• 聚合与更新能力：$merge 在 4.4 才完整支持，升级前需核查聚合管道是否使用该算子。
• 特性兼容版本 FCV：跨版本升级（如 4.2 → 4.4）建议在升级完成后，按需在 admin.system.version 中设置 featureCompatibilityVersion，以控制特性开关与回退能力。

三 常见兼容性问题与修复

• CPU 不支持 AVX（5.x/6.x 无法启动）：现象为启动即报“illegal instruction”或类似错误；处理为回退到 4.4 系列（该系列对老 CPU 更友好）。
• 远程连接被拒绝（绑定地址限制）：默认仅绑定 localhost；需在配置中设置 net.bindIp: 0.0.0.0 或 –bind_ip_all，并确保防火墙放行 27017。
• 旧版授权字段冲突（3.4 远程鉴权失败）：若 authSchema 与服务器版本不一致，可能导致 “Authorization failed”；可按 3.4 的要求将 authSchema.currentVersion 调整为 3 后重启并创建用户。
• 工具链缺失（4.2.24+）：mongorestore/mongodump 等不再随 server 包提供，需单独安装 MongoDB Database Tools 对应版本。

四 升级与迁移建议

• 升级路径：建议按 4.2 → 4.4 → 5.0 逐级升级；每步完成前先备份、在预发环境验证，再切换生产。
• 标准步骤：
  1. 全量备份（文件系统快照或 mongodump）；
  2. 安装目标版本二进制（匹配 rhel70 等构建）；
  3. 按需调整配置（如 bindIp、存储路径、日志等）；
  4. 启动并检查日志无异常；
  5. 连接验证与业务冒烟；
  6. 升级完成后设置 featureCompatibilityVersion（如需）。
• 回退预案：保留旧版本二进制与数据目录快照，出现严重问题时快速回滚并重放增量备份。

五 快速自检清单

• 查看系统版本：cat /etc/centos-release；查看 CPU 特性：grep -q avx /proc/cpuinfo && echo AVX || echo no AVX。
• 查看 MongoDB 版本：mongod --version 与 mongo --version（或新 shell mongosh --version）。
• 检查构建匹配：ldd $(which mongod) 确认无缺失依赖；配置文件使用对应 rhel70 的 YAML/INI。
• 验证网络与鉴权：ss -lntp | grep 27017；配置文件 net.bindIp 与 security.authorization 是否符合预期。
• 核查 FCV（如需）：在 admin 库执行 db.system.version.findOne({_id: “featureCompatibilityVersion”})。