Kubernetes部署MongoDB副本集报错：所有主机映射至同一节点

错误原因 #

这个错误是因为MongoDB节点无法区分自身与其他副本节点，通常由以下原因导致：

• MongoDB启动时未正确配置bindIp，仅绑定本地回环地址（127.0.0.1），导致节点无法通过集群域名识别自身或其他节点
• 初始化副本集时一次性添加所有成员，当前节点还未完成自身网络标识确认，误判所有主机名指向自己
• StatefulSet对应的Headless Service配置异常，导致Pod域名解析出现问题

正确初始化步骤 #

1. 确保MongoDB启动参数正确 #

每个Pod启动MongoDB时，必须指定副本集名称，并允许所有IP访问（或明确绑定Pod的IP和主机名），示例启动命令：

mongod --replSet rs0 --bind_ip_all --auth

如果使用配置文件，确保配置包含：

net:
  bindIpAll: true
replication:
  replSetName: rs0
security:
  authorization: enabled

2. 分步骤初始化副本集 #

不要一次性添加所有成员，先初始化主节点，再逐个添加从节点：

• 第一步：连接到第一个Pod，初始化仅包含自身的副本集

  mongo "mongodb://mongo-replica-0.mongo:27017" -u $MONGO_INITDB_ROOT_USERNAME -p $MONGO_INITDB_ROOT_PASSWORD --eval "rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'mongo-replica-0.mongo:27017' }] })"
  

• 第二步：等待10-20秒，确认节点变为PRIMARY后，添加第二个节点

  mongo "mongodb://mongo-replica-0.mongo:27017" -u $MONGO_INITDB_ROOT_USERNAME -p $MONGO_INITDB_ROOT_PASSWORD --eval "rs.add('mongo-replica-1.mongo:27017')"
  

3. 验证网络与域名解析 #

• 在任意MongoDB Pod内执行nslookup mongo-replica-0.mongo和nslookup mongo-replica-1.mongo，确认两个域名分别解析到对应Pod的不同IP
• 测试端口连通性：在mongo-replica-0内执行nc -zv mongo-replica-1.mongo 27017，确保能连接成功

4. 检查Headless Service配置 #

确保StatefulSet对应的是Headless Service（clusterIP: None），示例Service配置：

apiVersion: v1
kind: Service
metadata:
  name: mongo
spec:
  clusterIP: None
  selector:
    app: mongo-replica
  ports:
  - port: 27017
    targetPort: 27017

验证副本集状态 #

执行以下命令确认副本集正常运行：

mongo "mongodb://mongo-replica-0.mongo:27017" -u $MONGO_INITDB_ROOT_USERNAME -p $MONGO_INITDB_ROOT_PASSWORD --eval "rs.status()"

输出中应显示两个节点，一个为PRIMARY，一个为SECONDARY。

内容的提问来源于stack exchange，提问作者Brandon Kauffman