MongoDB非Docker集群添加Docker节点：新节点卡在STARTUP状态

我之前处理过不少MongoDB副本集从物理/非Docker节点迁移到Docker环境的案例，你的新节点卡在STARTUP状态，大概率是网络连通、配置一致性或者认证权限这几个环节出了问题。下面从前置准备工作和排查日志/操作两部分给你详细梳理：

这些准备能从根源避免大部分同步失败的问题：

• 确保网络全连通：
  • Docker节点容器必须能访问现有集群所有节点的27017（服务端口）和27019（副本集心跳端口），反之现有节点也要能访问Docker容器的这两个端口。
  • 如果用Docker自定义网桥，要确保网桥和现有集群网络互通；生产环境优先考虑用host网络模式（--network host），减少网络转发带来的问题。
  • 检查现有节点的bindIp配置，不要限制为仅本地IP，要允许Docker节点的IP访问。
• 保持配置完全一致：
  • Docker节点的mongod.conf里，replSetName必须和现有副本集完全相同，这是副本集成员识别的核心标识。
  • 认证相关配置（security.authorization、security.keyFile）、存储引擎（storage.engine）、日志级别、journaling设置等，要和现有集群节点的配置一一匹配。
• 认证权限配置到位：
  • 如果集群开启了认证，Docker节点必须使用和现有集群完全相同的keyFile（挂载到容器内指定路径），副本集成员之间靠这个做内部认证。
  • 确保admin库中存在拥有clusterAdmin或root权限的用户，Docker节点加入时需要用这个用户完成认证。
• 数据目录权限与空间：
  • Docker容器的数据目录要挂载到宿主机目录，并且宿主机目录的权限要匹配MongoDB容器内的运行用户（默认是mongodb用户，UID/GID通常是999），可以用chown -R 999:999 /path/to/host/data设置。
  • 确保挂载目录有足够的磁盘空间，至少和现有集群节点的数据量相当（初始同步会全量复制数据）。
• 版本严格兼容：
  • Docker镜像的MongoDB版本必须和现有集群的版本一致，或者是同大版本的小版本升级（比如4.4.10到4.4.15），跨大版本（比如4.2到5.0）会直接导致同步失败，需要先升级现有集群再添加Docker节点。

如果已经添加了节点但卡在STARTUP，优先查这些地方：

• Docker节点的mongod日志：
  • 用命令docker logs <your-mongo-container-name>查看容器内的mongod日志，重点找以下关键词：
    • Failed to connect to：说明网络连通有问题，目标节点IP/端口无法访问。
    • replSetName mismatch：配置文件里的副本集名称和现有集群不一致。
    • authentication failed：keyFile不匹配或者认证用户权限不足。
    • Permission denied：数据目录权限配置错误，容器内无法写入数据。
• 现有主节点的mongod日志：
  • 登录现有主节点，查看mongod的日志文件（通常在/var/log/mongodb/mongod.log），找是否有拒绝Docker节点连接的记录，比如connection refused或者unauthorized的提示。
• 网络连通性测试：
  • 进入Docker容器内部：docker exec -it <container-name> bash
  • 测试和现有主节点的连通性：telnet <primary-node-ip> 27017、telnet <primary-node-ip> 27019，如果连接失败，说明网络有防火墙或路由问题。
• 副本集状态检查：
  • 在现有主节点上运行mongo客户端，执行rs.status()，查看输出中的members列表：
    • 如果新节点不在列表中，说明还没成功加入副本集，需要重新执行rs.add("<docker-node-ip>:27017")。
    • 如果新节点在列表中，查看stateStr和errMsg字段，这里会直接显示节点卡壳的原因（比如STARTUP2是正在同步，STARTUP可能是配置不匹配或网络问题）。

内容的提问来源于stack exchange，提问作者Jeff Blanchard